共用方式為

IItemMetadata::GetGlobalId

  • 發行項

取得此項目的全域識別碼。

HRESULT GetGlobalId(
  BYTE * pbGlobalId,
  ULONG * pcbGlobalId);

參數

  • pbGlobalId
    [in, out, size_is(*pcbGlobalId), unique] 傳回此項目的全域識別碼。
  • pcbGlobalId
    [in, out] 指定 pbGlobalId 中的位元組數目。如果 pbGlobalId 太小，就傳回擷取此全域識別碼所需的位元組數目，否則就傳回寫入的位元組數目。

傳回值

  • S_OK。

  • 如果這個全域識別碼尚未設定，則為 S_FALSE。

  • E_POINTER。

  • 如果 pbGlobalId 不夠大，無法接收此欄位值，則為 HRESULT_FROM_WIN32(ERROR_MORE_DATA)。在這種情況下，pcbGlobalId 會傳回所需的位元組數目。

備註

此全域識別碼可在整個同步處理範圍內識別此項目。

所傳回識別碼的格式取決於初始化此複寫時所指定的識別碼格式結構描述。如需識別碼格式的詳細資訊，請參閱標準提供者的中繼資料需求。

如果呼叫了 IItemMetadata::SetGlobalId 來設定全域識別碼值，但是對 IReplicaMetadata::SaveItemMetadata 的呼叫尚未儲存變更，則 GetGlobalId 會傳回 IItemMetadata 物件中包含的值，而不是中繼資料存放區中儲存的值。

請參閱

參考

IItemMetadata 介面