共用方式為


FilterVolumeFindNext 函式 (fltuser.h)

FilterVolumeFindNext函式會繼續呼叫FilterVolumeFindFirst所啟動的磁片區搜尋。

語法

HRESULT FilterVolumeFindNext(
  [in]  HANDLE                          hVolumeFind,
  [in]  FILTER_VOLUME_INFORMATION_CLASS dwInformationClass,
  [out] LPVOID                          lpBuffer,
  [in]  DWORD                           dwBufferSize,
  [out] LPDWORD                         lpBytesReturned
);

參數

[in] hVolumeFind

先前呼叫 FilterVolumeFindFirst所傳回的磁片區搜尋控制碼。

[in] dwInformationClass

要求的資訊類型。 此參數可以是下列其中一個值。

意義
FilterVolumeBasicInformation lpBuffer參數指向的緩衝區會收到磁片區的FILTER_VOLUME_BASIC_INFORMATION結構。
FilterVolumeStandardInformation lpBuffer參數指向的緩衝區會收到磁片區的FILTER_VOLUME_STANDARD_INFORMATION結構。 從 Windows Vista 開始,即可使用此結構。

[out] lpBuffer

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

[in] dwBufferSize

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

[out] lpBytesReturned

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

傳回值

FilterVolumeFindNext 如果成功傳回磁片區資訊,則會傳回S_OK。 否則,它會傳回 HRESULT 錯誤值,例如下列其中一項:

傳回碼 描述
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)
lpBuffer指向的緩衝區不夠大,無法包含要求的資訊。 傳回此值時, lpBytesReturned 會包含指定 dwInformationClass 結構所需的緩衝區大小,以位元組為單位。
HRESULT_FROM_WIN32 (ERROR_INVALID_PARAMETER)
dwInformationClass 參數指定了不正確值。 例如,如果在 Windows Vista 之前為作業系統指定 FilterVolumeStandardInformationFilterVolumeFindNext 會傳回此 HRESULT 值。
HRESULT_FROM_WIN32 (ERROR_NO_MORE_ITEMS)
篩選管理員已知的磁片區清單中找不到更多磁片區。

備註

藉由呼叫 FilterVolumeFindFirst建立搜尋控制碼之後,請使用 FilterVolumeFindNext 函式來搜尋其他磁片區。 FilterVolumeFindNext 會為每個呼叫尋找一個磁片區。

請注意,使用 FilterVolumeFindFirstFilterVolumeFindNext 列舉篩選管理員已知的磁片區清單時,清單中的兩個或多個磁片區可能會有相同的名稱。 如需詳細資訊,請參閱 瞭解具有重複磁片區名稱的磁片區列舉

需求

   
目標平台 Universal
標頭 fltuser.h (包含 FltUser.h)
程式庫 FltLib.lib
Dll FltLib.dll

另請參閱

FILTER_VOLUME_BASIC_INFORMATION

FILTER_VOLUME_STANDARD_INFORMATION

FilterVolumeFindClose

FilterVolumeFindFirst