Partager via


ISqlSyncMetadataStore::CreateStore

Crée un fichier de magasin des métadonnées et un objet de magasin des métadonnées pour le représenter.

HRESULT CreateStore(
  LPCWSTR pcszFileName,
  ULONG   ulLcid);

Paramètres

Paramètre Description

pcszFileName

[in, string] Chemin d'accès et nom du fichier de base de données. Le chemin d'accès au fichier doit exister avant l'appel de cette méthode. Le chemin d'accès au fichier peut être un chemin d'accès relatif. Dans ce cas, il est relatif au répertoire actif.

ulLcid

[in] ID de paramètres régionaux à utiliser pour créer la base de données.

Valeur de retour

  • S_OK

  • E_POINTER

  • E_INVALIDARG lorsque pcszFileName est vide.

  • SYNC_E_METADATA_INVALID_OPERATION lorsque l'emplacement spécifié par pcszFileName n'est pas disponible, par exemple lorsqu'il est déjà utilisé.

  • SYNC_E_METADATA_STORAGE_ENGINE_ERROR lorsque le magasin des métadonnées ne peut pas être créé ou est inaccessible.

Notes

Si le fichier n'existe pas à l'emplacement spécifié par pcszFileName, il sera créé.

Security noteSécurité Remarque

Le fichier de métadonnées n'est pas sécurisé contre tout accès non autorisé. Pour mieux protéger le fichier de métadonnées, le dossier qui le contient doit être sécurisé correctement, par exemple en utilisant une liste de contrôle d'accès discrétionnaire (DACL, Discretionary Access Control List). Pour permettre à l'utilisateur de supprimer le fichier de métadonnées, le fournisseur qui crée ce fichier doit le placer dans un emplacement accessible par l'utilisateur. Le fournisseur qui crée le fichier de métadonnées doit supprimer ce fichier lorsque le fournisseur est désinstallé.

Security noteSécurité Remarque

Lorsque Sync Framework ouvre le fichier de métadonnées par un mécanisme distant, tel qu'un chemin d'accès UNC, le fichier de métadonnées ne peut pas faire l'objet d'un accès simultané par une autre application d'un ordinateur, notamment une application sur l'ordinateur sur lequel le fichier de métadonnées est stocké.

Voir aussi

Référence

Interface ISqlSyncMetadataStore