IItemMetadata::SetGlobalId
設定此項目的全域識別碼。
HRESULT SetGlobalId(
const BYTE * pbGlobalId);
參數
- pbGlobalId
[in] 全域識別碼。
傳回值
S_OK
E_POINTER
E_OUTOFMEMORY
如果已經設定了全域識別碼,則為 E_UNEXPECTED。
備註
全域識別碼的格式必須符合此複寫初始化時指定的識別碼格式結構描述。
每個 IItemMetadata 項目都必須有唯一且有效的全域識別碼,然後才能儲存到中繼資料存放區。如果呼叫了 IReplicaMetadata::SaveItemMetadata 但全域識別碼無效,IReplicaMetadata::SaveItemMetadata 就會傳回 SYNC_E_METADATA_PRIMARY_KEY_CONSTRAINT。
注意
這個方法不會將變更儲存到存放區,必須呼叫 IReplicaMetadata::SaveItemMetadata 來儲存對 IItemMetadata 屬性做的所有變更。