ISqlSyncMetadataStore::OpenStore

打开一个现有元数据存储区文件，并返回一个表示该文件的元数据存储区对象。

HRESULT OpenStore(
  LPCWSTR pcszFileName,
  ULONG   ulLcid);

参数

• pcszFileName
  [in, string] 数据库文件的文件路径和文件名。该文件路径可以是相对路径。在这种情况下，该值为相对于当前目录的路径。

• ulLcid
  [in] 数据库的区域设置 ID。该值必须是在调用 ISqlSyncMetadataStore::CreateStore 时用于创建元数据存储区的本地 ID。

返回值

• S_OK

• E_POINTER

• 如果 pcszFileName 为空，则返回值为 E_INVALIDARG。

• 如果元数据存储区已打开，则返回值为 SYNC_E_METADATA_INVALID_OPERATION，当调用 OpenStore 两次后会发生这种情况。

• 如果无法访问元数据存储区，则返回值为 SYNC_E_METADATA_STORAGE_ENGINE_ERROR。

备注

此方法打开现有的元数据存储区。若要创建新的元数据存储区文件，请使用 ISqlSyncMetadataStore::CreateStore。

安全性注意
元数据文件未受到保护，无法避免未经授权的访问。若要帮助保护元数据文件，必须对包含它的文件夹进行适当的安全设置，例如通过使用任意访问控制列表 (DACL) 来提供保护。若要允许用户删除元数据文件，创建元数据文件的提供程序应将该文件放置于用户可以访问的位置。在卸载创建元数据文件的提供程序时，该提供程序必须删除元数据文件。

安全性注意
在 Sync Framework 通过远程机制（例如 UNC 路径）打开元数据文件时，元数据文件不能同时被任意计算机上的任何其他应用程序访问，包括存储了元数据文件的计算机上的应用程序。

请参阅

参考

ISqlSyncMetadataStore 接口