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 接口