Funzione FltSetVolumeInformation (fltkernel.h)

  • Articolo

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