ICoreFragment::NextRange

傳回包含在此知識片段中的下一個範圍，以及定義範圍內項目之相關已知資料的時鐘向量。

HRESULT NextRange(
  BYTE* pItemId,
  DWORD* pItemIdSize,
  IClockVector** piClockVector);

參數

• pItemId
  [in, out, unique, size_is(*pItemIdSize)] 傳回此範圍中項目識別碼的封閉下限。當此範圍不是範圍設定中的第一個範圍時，這個值也是上一個範圍內項目識別碼的開放上限。

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

• piClockVector
  [out] 傳回定義範圍內項目之相關已知資料的時鐘向量。

傳回值

• S_OK

• 如果沒有其他範圍可列舉，則為 S_FALSE。

• 如果項目識別碼為可變長度識別碼，而 pItemIdSize 為 NULL，則為 E_POINTER。

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

• 如果此物件中包含的知識物件在這個物件建立之後已經變更，則為 SYNC_E_INVALID_OPERATION。

備註

在 pItemId 中傳回的值是項目識別碼範圍的封閉下限，而這些項目識別碼與在 piClockVector 中傳回的時鐘向量相關聯。pItemId 的值也會定義上一個範圍的開放上限，因此您可以透過再次呼叫 NextRange，取得目前範圍的開放上限。如果沒有其他範圍可列舉，這個範圍就會包含識別碼大於或等於 pItemId 的所有項目。

請參閱

參考

ICoreFragment 介面