FilterVolumeInstanceFindNext 函式 (fltuser.h)

發行項
02/29/2024

FilterVolumeInstanceFindNext 函式會繼續小型篩選驅動程序實例或舊版篩選驅動程式搜尋，從呼叫 FilterVolumeInstanceFindFirst 開始。

語法

HRESULT FilterVolumeInstanceFindNext(
  [in]  HANDLE                     hVolumeInstanceFind,
  [in]  INSTANCE_INFORMATION_CLASS dwInformationClass,
  [out] LPVOID                     lpBuffer,
  [in]  DWORD                      dwBufferSize,
  [out] LPDWORD                    lpBytesReturned
);

參數

[in] hVolumeInstanceFind

先前呼叫 FilterVolumeInstanceFindFirst 所傳回的磁碟區篩選驅動程式搜尋句柄。

[in] dwInformationClass

傳回的篩選驅動程式資訊結構類型。此參數必須包含下列其中一個值。

值	意義
InstanceBasicInformation	傳回迷你篩選實例的INSTANCE_BASIC_INFORMATION 結構。會忽略舊版篩選驅動程式。
InstanceFullInformation	傳回迷你篩選實例的INSTANCE_FULL_INFORMATION 結構。會忽略舊版篩選驅動程式。
InstancePartialInformation	傳回迷你篩選實例的 INSTANCE_PARTIAL_INFORMATION 結構。會忽略舊版篩選驅動程式。
InstanceAggregateStandardInformation	傳回實例的INSTANCE_AGGREGATE_STANDARD_INFORMATION 結構。不會使用結構的 LegacyFilter 成員。從 Windows Vista 開始，即可使用此結構。

[out] lpBuffer

接收要求資訊的呼叫端配置緩衝區指標。緩衝區中傳回的信息類型是由 dwInformationClass 參數所定義。

[in] dwBufferSize

lpBuffer 參數指向的緩衝區大小，以位元組為單位。呼叫端應該根據指定的 dwInformationClass 來設定此參數。

[out] lpBytesReturned

呼叫端配置的變數指標，這個變數會接收 lpBuffer 所指向之緩衝區中傳回的位元組數目，如果 FilterVolumeInstanceFindNext 的呼叫成功。這個參數是必要的，而且不能是 NULL。

傳回值

FilterVolumeInstanceFindNext 會在成功時傳回S_OK。否則，它會傳回 HRESULT 錯誤值，例如下列其中一項：

傳回碼	Description
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	lpBuffer 所指向的緩衝區不夠大，無法包含要求的資訊。傳回此值時， lpBytesReturned 會包含指定 dwInformationClass 結構所需的緩衝區大小，以位元組為單位。
HRESULT_FROM_WIN32 (ERROR_INVALID_PARAMETER)	為 dwInformationClass 參數指定了無效的值。例如，如果在 Windows Vista 之前為操作系統指定 InstanceAggregateStandardInformation，FilterVolumeInstanceFindNext 會傳回此 HRESULT 值。
HRESULT_FROM_WIN32 (ERROR_NO_MORE_ITEMS)	在指定的磁碟區上找不到更多篩選驅動程式。

備註

FilterVolumeInstanceFindNext 會為每個呼叫尋找一個篩選驅動程式。

藉由呼叫 FilterVolumeInstanceFindFirst 建立搜尋句柄之後，請使用 FilterVolumeInstanceFindNext 函式來搜尋附加至 FilterVolumeInstanceFindFirst 呼叫中指定的磁碟區的其他篩選驅動程式。不再需要搜尋句柄時，請呼叫 FilterVolumeInstanceFindClose 來關閉它。

從 Windows Vista 開始，當 dwInformationClass 參數的值是 InstanceAggregateStandardInformation 時，此例程可以傳回舊版篩選驅動程式資訊和迷你篩選驅動程式實例資訊。對於先前的操作系統，此例程無法傳回舊版篩選資訊，因為無法使用INSTANCE_AGGREGATE_STANDARD_INFORMATION結構。