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

请参阅

参考

ISyncChange 接口