Funzione FilterVolumeFindFirst (fltuser.h)

Articolo
08/23/2023

La funzione FilterVolumeFindFirst restituisce informazioni su un volume.

Sintassi

HRESULT FilterVolumeFindFirst(
  [in]  FILTER_VOLUME_INFORMATION_CLASS dwInformationClass,
  [out] LPVOID                          lpBuffer,
  [in]  DWORD                           dwBufferSize,
  [out] LPDWORD                         lpBytesReturned,
  [out] PHANDLE                         lpVolumeFind
);

Parametri

[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 FilterVolumeFindFirst riesce. Questo parametro è obbligatorio e non può essere NULL.

[out] lpVolumeFind

Puntatore a una variabile allocata del chiamante che riceve un handle di ricerca per il minifilter se la chiamata a FilterVolumeFindFirst ha esito positivo; in caso contrario, riceve INVALID_HANDLE_VALUE. Questo handle di ricerca può essere usato nelle chiamate successive a FilterVolumeFindNext e FilterVolumeFindClose.

Valore restituito

FilterVolumeFindFirst restituisce S_OK se restituisce correttamente informazioni su un 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, FilterVolumeFindFirst restituisce questo valore HRESULT.
HRESULT_FROM_WIN32(ERROR_NO_MORE_ITEMS)	Un volume non è stato trovato nell'elenco dei volumi noti al gestore filtri.

Commenti

Questa funzione FilterVolumeFindFirst viene usata per iniziare a analizzare i volumi noti alla gestione filtri.

FilterVolumeFindFirst apre un handle di ricerca e restituisce informazioni sul primo volume trovato nell'elenco di volumi noti alla gestione filtri. Dopo aver stabilito l'handle di ricerca, usare la funzione FilterVolumeFindNext per cercare altri volumi nell'elenco di gestione filtri. Quando l'handle di ricerca non è più necessario, chiuderlo chiamando FilterVolumeFindClose.

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.