Funzione FilterVolumeFindNext (fltuser.h)

Articolo
03/09/2023

La funzione FilterVolumeFindNext continua una ricerca del volume avviata da una chiamata a FilterVolumeFindFirst.

Sintassi

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

Parametri

[in] hVolumeFind

Handle di ricerca dei volumi restituito da una chiamata precedente a FilterVolumeFindFirst.

[in] dwInformationClass

Tipo di informazioni richieste. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
FilterVolumeBasicInformation	Il buffer a cui punta il parametro lpBuffer riceve una struttura FILTER_VOLUME_BASIC_INFORMATION per il volume.
FilterVolumeStandardInformation	Il buffer a cui punta il parametro lpBuffer riceve una struttura FILTER_VOLUME_STANDARD_INFORMATION per il volume. Questa struttura è disponibile a partire da Windows Vista.

[out] lpBuffer

Puntatore a un buffer allocato dal chiamante che riceve le informazioni richieste. Il tipo delle informazioni restituite nel buffer è definito dal parametro dwInformationClass .

[in] dwBufferSize

Dimensioni, in byte, del buffer a cui punta il parametro lpBuffer . Il chiamante deve impostare questo parametro in base all'oggetto dwInformationClass specificato.

[out] lpBytesReturned

Puntatore a una variabile allocata dal chiamante che riceve il numero di byte restituiti nel buffer a cui lpBuffer punta se la chiamata a FilterVolumeFindNext ha esito positivo. Questo parametro è obbligatorio e non può essere NULL.

Valore restituito

FilterVolumeFindNext restituisce S_OK se restituisce correttamente le informazioni sul volume. In caso contrario, restituisce un valore di errore HRESULT, ad esempio uno dei seguenti:

Codice restituito	Descrizione
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	Il buffer a cui punta lpBuffer non è sufficiente per contenere le informazioni richieste. Quando viene restituito questo valore, lpBytesReturned conterrà le dimensioni, in byte, del buffer necessario per la struttura dwInformationClass specificata.
HRESULT_FROM_WIN32(ERROR_INVALID_PARAMETER)	È stato specificato un valore non valido per il parametro dwInformationClass . Ad esempio, se FilterVolumeStandardInformation viene specificato per un sistema operativo prima di Windows Vista, FilterVolumeFindNext restituisce questo valore HRESULT.
HRESULT_FROM_WIN32(ERROR_NO_MORE_ITEMS)	Non sono stati trovati più volumi nell'elenco di volumi noti al gestore filtri.

Commenti

Dopo aver stabilito l'handle di ricerca chiamando FilterVolumeFindFirst, usare la funzione FilterVolumeFindNext per cercare altri volumi. FilterVolumeFindNext trova un volume per chiamata.

Si noti che quando si usa FilterVolumeFindFirst e FilterVolumeFindNext per enumerare l'elenco di volumi noti alla gestione filtri, è possibile che due o più volumi nell'elenco abbiano lo stesso nome. Per altre informazioni, vedere Informazioni sulle enumerazioni dei volumi con nomi di volume duplicati.