Funzione FltSetVolumeInformation (fltkernel.h)

Articolo
02/06/2025

FltSetVolumeInformation modifica vari tipi di informazioni sul volume a cui è collegata 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 a istanze opache per un'istanza del driver minifiltro 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 dal 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 punta FsInformation . Il chiamante deve impostare questo parametro in base all'FsInformationClass. Ad esempio, se il valore di FsInformationClass è FileFsControlInformation, Length 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 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	Il dell'istanza di è collegato a un volume di rete. FltSetVolumeInformation non può essere usato per impostare le informazioni sul volume di rete. Si tratta di un codice di errore.