IEnumItemIds::Next

在派生类中重写时，返回项 ID 列表中的下一个元素（如果存在）。

HRESULT Next(
  BYTE * pbItemId,
  DWORD * pcbItemIdSize);

参数

• pbItemId
  [in, out, unique, size_is(*pcbItemIdSize)] 列表中的下一个项 ID。

• pcbItemIdSize
  [in, out] 指定 pbItemId 中的字节数。如果 pbItemId 太小，则返回检索 ID 所需的字节数；否则返回写入的字节数。

返回值

• S_OK。

• 如果没有更多要检索的元素，则返回值为 S_FALSE。

• 如果 pbItemId 太小，则返回值为 HRESULT_FROM_WIN32(ERROR_MORE_DATA)。在这种情况下，则在 pcbItemIdSize 中返回必需的字节数。

• 提供程序指定的错误代码。

备注

Sync Framework 首次调用此方法时将为 pbItemId 指定 NULL，为 pcbItemIdSize 指定 0。在这种情况下，实现必须在 pcbItemIdSize 中返回正确的项 ID 大小，并返回错误代码 HRESULT_FROM_WIN32(ERROR_MORE_DATA)。

请参阅

参考

IEnumItemIds 接口