共用方式為


ISyncChange::GetRootItemId

取得已變更之項目的識別碼。

HRESULT GetRootItemId(
  BYTE * pbRootItemId,
  DWORD * pcbIdSize);

參數

  • pbRootItemId
    [in, out, unique, size_is(*pcbIdSize)] 傳回此項目的識別碼。
  • pcbIdSize
    [in, out] 指定 pbRootItemId 中的位元組數目。如果 pbRootItemId 太小,就傳回擷取此識別碼所需的位元組數目,或傳回寫入的位元組數目。

傳回值

  • S_OK

  • E_POINTER

  • 當 pbRootItemId 太小時,為 HRESULT_FROM_WIN32(ERROR_MORE_DATA)。在這種情況下,所需的位元組數目是在 pcbIdSize 中傳回。

範例

以下範例會示範,當識別碼是使用 SYNC_GID 結構儲存時,如何取得根項目識別碼。

SYNC_GID gidItem;
DWORD cbID = sizeof(gidItem);
hr = pChange->GetRootItemId((BYTE*)&gidItem, &cbID);

請參閱

參考

ISyncChange 介面