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);