ISqlSyncMetadataStore::OpenStore

Article
10/17/2009

Ouvre un fichier de magasin des métadonnées existant et retourne un objet de magasin des métadonnées qui le représente.

HRESULT OpenStore(
  LPCWSTR pcszFileName,
  ULONG   ulLcid);

Paramètres

pcszFileName
[in, string] Chemin d'accès et nom du fichier de base de données. 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 de la base de données. Il doit s'agir du même ID local que celui utilisé pour créer le magasin des métadonnées lorsque ISqlSyncMetadataStore::CreateStore a été appelée.

Valeur de retour

S_OK
E_POINTER
E_INVALIDARG lorsque pcszFileName est vide.
SYNC_E_METADATA_INVALID_OPERATION lorsque le magasin des métadonnées est déjà ouvert, ce qui se produit lorsque OpenStore est appelée deux fois.
SYNC_E_METADATA_STORAGE_ENGINE_ERROR lorsque le magasin des métadonnées est inaccessible.

Notes

Cette méthode ouvre un magasin des métadonnées existant. Pour créer un fichier de magasin des métadonnées, utilisez ISqlSyncMetadataStore::CreateStore.

Sé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é.

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é.

Sé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

Partager via