ISyncChange::GetRootItemId
获取变更的项的 ID。
HRESULT GetRootItemId(
BYTE * pbRootItemId,
DWORD * pcbIdSize);
参数
- pbRootItemId
[in, out, unique, size_is(*pcbIdSize)] 返回项的 ID。
- pcbIdSize
[in, out] 指定 pbRootItemId 中的字节数。如果 pbRootItemId 太小,则返回检索 ID 所需的字节数;否则返回写入的字节数。
返回值
S_OK
E_POINTER
如果 pbRootItemId 太小,则返回值为 HRESULT_FROM_WIN32(ERROR_MORE_DATA)。在这种情况下,将在 pcbIdSize 中返回必需的字节数。
示例
以下示例说明当通过使用 SYNC_GID 结构存储 ID 时,如何获得根项 ID。
SYNC_GID gidItem;
DWORD cbID = sizeof(gidItem);
hr = pChange->GetRootItemId((BYTE*)&gidItem, &cbID);