IItemMetadata::SetGlobalId
項目のグローバル ID を設定します。
構文
HRESULT SetGlobalId(
const BYTE * pbGlobalId);
パラメーター
- pbGlobalId
[in] グローバル ID。
戻り値
S_OK
E_POINTER
E_OUTOFMEMORY
グローバル ID が既に設定されている場合は E_UNEXPECTED。
説明
グローバル ID の形式は、レプリカを初期化したときに指定した ID 形式スキーマと一致する必要があります。
メタデータ ストアに保存するには、すべての IItemMetadata エントリに有効な一意のグローバル ID が必要です。グローバル ID が有効でない場合に IReplicaMetadata::SaveItemMetadata を呼び出すと、IReplicaMetadata::SaveItemMetadata から SYNC_E_METADATA_PRIMARY_KEY_CONSTRAINT が返されます。
注意
このメソッドでは変更がストアに保存されません。IItemMetadata プロパティに加えたすべての変更を保存するには、IReplicaMetadata::SaveItemMetadata を呼び出す必要があります。