Funzione FltGetVolumeFromName (fltkernel.h)

Articolo
02/29/2024

La routine FltGetVolumeFromName restituisce un puntatore opaco per il volume il cui nome corrisponde al valore del parametro VolumeName .

Sintassi

NTSTATUS FLTAPI FltGetVolumeFromName(
  [in]  PFLT_FILTER      Filter,
  [in]  PCUNICODE_STRING VolumeName,
  [out] PFLT_VOLUME      *RetVolume
);

Parametri

[in] Filter

Puntatore di filtro opaco per il chiamante. Questo parametro è obbligatorio e non può essere NULL.

[in] VolumeName

Puntatore a una struttura UNICODE_STRING contenente il nome del volume , ad esempio "\Device\HarddiskVolume1", "\DosDevices\D:", "\?? \D:", o "D:"). Questo parametro è obbligatorio e non può essere NULL.

[out] RetVolume

Puntatore a una variabile allocata dal chiamante che riceve un puntatore opaco per il volume. Questo parametro è obbligatorio e non può essere NULL.

Valore restituito

FltGetVolumeFromName restituisce STATUS_SUCCESS o un valore NTSTATUS appropriato, ad esempio uno dei seguenti:

Codice restituito	Descrizione
STATUS_ACCESS_DENIED	Il chiamante non ha FILE_READ_DATA accesso al volume. Si tratta di un codice di errore.
STATUS_FLT_DELETING_OBJECT	Il volume viene eliminato. Si tratta di un codice di errore.
STATUS_INVALID_PARAMETER	È stato specificato un valore non valido per il parametro VolumeName . Si tratta di un codice di errore.
STATUS_FLT_VOLUME_NOT_FOUND	Non è stato trovato alcun volume corrispondente. Si tratta di un codice di errore.

Commenti

FltGetVolumeFromName cerca l'elenco globale di volumi di Filter Manager per un volume il cui nome corrisponde a VolumeName. Il chiamante deve avere FILE_READ_DATA accesso al volume. Per individuare la struttura del volume, FltGetVolumeFromName deve prima aprire il volume.

FltGetVolumeFromName aggiunge un riferimento di rundown al puntatore del volume opaco restituito nel parametro RetVolume . Quando questo puntatore non è più necessario, il chiamante deve rilasciarlo chiamando FltObjectDereference. Pertanto ogni chiamata riuscita a FltGetVolumeFromName deve essere corrispondente a una chiamata successiva a FltObjectDereference.

Per ottenere il nome del volume per un determinato volume, chiamare FltGetVolumeName.

Per ottenere il nome GUID del volume per un determinato volume, chiamare FltGetVolumeGuidName.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Intestazione	fltkernel.h (includere Fltkernel.h)
Libreria	FltMgr.lib
DLL	Fltmgr.sys
IRQL	PASSIVE_LEVEL