Share via

ISqlSyncMetadataStore::CreateStore

  • 项目

创建一个元数据存储区文件和一个表示该文件的元数据存储区对象。

HRESULT CreateStore(
  LPCWSTR pcszFileName,
  ULONG   ulLcid);

参数

参数 说明

pcszFileName

[in, string] 数据库文件的文件路径和文件名。文件路径必须存在才能调用此方法。该文件路径可以是相对路径。在这种情况下，该值为相对于当前目录的路径。

ulLcid

[in] 用于创建数据库的区域设置 ID。

返回值

  • S_OK

  • E_POINTER

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

  • 如果 pcszFileName 指定的位置不可用（如该位置已被使用），则返回值为 SYNC_E_METADATA_INVALID_OPERATION。

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

备注

如果文件在 pcszFileName 指定的位置不存在，则将创建该文件。

Security note安全性注意

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

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

请参阅

参考

ISqlSyncMetadataStore 接口