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 インターフェイス