IKnowledgeWithMarkers::NextAllChangeUnitsRequiredMarker

傳回標示為需要所有變更單位之項目清單中的下一個項目。

HRESULT NextAllChangeUnitsRequiredMarker(
  BYTE * pItemId,
  DWORD * pIdSize);

參數

• pItemId
  [in, out, unique, size_is(*pIdSize)] 傳回標示為需要所有變更單位之項目識別碼清單中的下一個項目識別碼。

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

傳回值

• S_OK。

• 如果清單中沒有其他項目，或知識物件包含的項目標示為包含所有變更單位，為 S_FALSE。

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

• 如果 pIdSize 大於項目識別碼格式結構描述所指定的大小上限，為 E_INVALIDARG。

• 如果項目識別碼為可變長度而且 pIdSize 是 NULL，為 E_POINTER。

備註

使用自訂篩選器時，來源提供者必須檢查加入至變更批次的項目是否需要包含所有變更單位。若要這樣做，請呼叫 IKnowledgeWithMarkers::ContainsAllChangeUnitsRequiredMarker 或使用 NextAllChangeUnitsRequiredMarker 來列舉項目。當某個項目標示為需要所有變更單位時，來源提供者必須包含通過該項目之篩選器的所有變更單位。

請參閱

參考

IKnowledgeWithMarkers 介面