Funzione FltSetVolumeInformation (fltkernel.h)

Articolo
08/07/2023

FltSetVolumeInformation modifica vari tipi di informazioni sul volume a cui è associata l'istanza specificata.

Sintassi

NTSTATUS FLTAPI FltSetVolumeInformation(
  [in]  PFLT_INSTANCE        Instance,
  [out] PIO_STATUS_BLOCK     Iosb,
  [out] PVOID                FsInformation,
  [in]  ULONG                Length,
  [in]  FS_INFORMATION_CLASS FsInformationClass
);

Parametri

[in] Instance

Puntatore istanza opaca per un'istanza del driver minifilter collegata al volume.

[out] Iosb

Puntatore a una struttura IO_STATUS_BLOCK che riceve lo stato di completamento finale e informazioni sull'operazione.

[out] FsInformation

Puntatore a un buffer allocato del chiamante contenente i valori da impostare per il volume. La struttura delle informazioni contenute nel buffer è definita dal parametro FsInformationClass .

[in] Length

Dimensioni in byte del buffer a cui fsInformation punta. Il chiamante deve impostare questo parametro in base all'oggetto FsInformationClass specificato. Ad esempio, se il valore di FsInformationClass è FileFsControlInformation, la lunghezza deve essere almeno sizeof(FILE_FS_CONTROL_INFORMATION).

[in] FsInformationClass

Tipo di informazioni da impostare per il volume. Uno dei seguenti.

Valore	Significato
FileFsControlInformation	Impostare FILE_FS_CONTROL_INFORMATION per il volume.
FileFsLabelInformation	Impostare FILE_FS_LABEL_INFORMATION per il volume.
FileFsObjectIdInformation	Impostare FILE_FS_OBJECTID_INFORMATION per il volume.

Valore restituito

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

Codice restituito	Descrizione
STATUS_INFO_LENGTH_MISMATCH	È stato specificato un valore non valido per Length. Si tratta di un codice di errore.
STATUS_INSUFFICIENT_RESOURCES	FltSetVolumeInformation ha rilevato un errore di allocazione del pool. Si tratta di un codice di errore.
STATUS_INVALID_INFO_CLASS	È stato specificato un valore non valido per FsInformationClass. Si tratta di un codice di errore.
STATUS_INVALID_PARAMETER	L'istanza è collegata a un volume di rete. Non è possibile usare FltSetVolumeInformation per impostare le informazioni sul volume di rete. Si tratta di un codice di errore.

Commenti

Per eseguire query su un volume, chiamare FltQueryVolumeInformation.

Requisiti

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

Vedi anche

FILE_FS_CONTROL_INFORMATION

FILE_FS_LABEL_INFORMATION

FILE_FS_OBJECTID_INFORMATION

FltQueryVolumeInformation

Condividi tramite