IEnumItemIds::Next

在衍生類別中覆寫時，會傳回項目識別碼清單中的下一個元素 (如果有的話)。

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

參數

• pbItemId
  [in, out, unique, size_is(*pcbItemIdSize)] 清單中的下一個項目識別碼。

• pcbItemIdSize
  [in, out] 指定 pbItemId 中的位元組數目。如果 pbItemId 太小，就傳回擷取此識別碼所需的位元組數目，否則就傳回寫入的位元組數目。

傳回值

• S_OK。

• 如果已經沒有其他元素可擷取，則為 S_FALSE。

• 當 pbItemId 太小時，則為 HRESULT_FROM_WIN32(ERROR_MORE_DATA)。在這種情況下，所需的位元組數目是在 pcbItemIdSize 中傳回。

• 提供者指定的錯誤碼。

備註

Sync Framework 第一次呼叫此方法時，它會指定 NULL 給 pbItemId，並指定 0 給 pcbItemIdSize。在此情況下，實作必須在 pcbItemIdSize 中傳回項目識別碼的正確大小，以及 HRESULT_FROM_WIN32(ERROR_MORE_DATA) 的錯誤碼。

請參閱

參考

IEnumItemIds 介面