Función FltSetVolumeInformation (fltkernel.h)

Artículo
02/26/2024

FltSetVolumeInformation cambia varios tipos de información sobre el volumen al que se adjunta la instancia especificada.

Sintaxis

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

Parámetros

[in] Instance

Puntero de instancia opaco para una instancia de controlador de minifiltro que está asociada al volumen.

[out] Iosb

Puntero a una estructura de IO_STATUS_BLOCK que recibe el estado de finalización final e información sobre la operación.

[out] FsInformation

Puntero a un búfer asignado por el autor de la llamada que contiene los valores que se van a establecer para el volumen. La estructura de la información contenida en el búfer se define mediante el parámetro FsInformationClass .

[in] Length

Tamaño en bytes del búfer al que apunta FsInformation . El autor de la llamada debe establecer este parámetro según el FsInformationClass especificado. Por ejemplo, si el valor de FsInformationClass es FileFsControlInformation, Length debe ser al menos sizeof(FILE_FS_CONTROL_INFORMATION).

[in] FsInformationClass

Tipo de información que se va a establecer para el volumen. Uno de los siguientes.

Valor	Significado
FileFsControlInformation	Establezca FILE_FS_CONTROL_INFORMATION para el volumen.
FileFsLabelInformation	Establezca FILE_FS_LABEL_INFORMATION para el volumen.
FileFsObjectIdInformation	Establezca FILE_FS_OBJECTID_INFORMATION para el volumen.

Valor devuelto

FltSetVolumeInformation devuelve STATUS_SUCCESS o un valor NTSTATUS adecuado, como uno de los siguientes:

Código devuelto	Descripción
STATUS_INFO_LENGTH_MISMATCH	Se especificó un valor no válido para Length. Se trata de un código de error.
STATUS_INSUFFICIENT_RESOURCES	FltSetVolumeInformation encontró un error de asignación de grupo. Se trata de un código de error.
STATUS_INVALID_INFO_CLASS	Se especificó un valor no válido para FsInformationClass. Se trata de un código de error.
STATUS_INVALID_PARAMETER	La instancia está conectada a un volumen de red. FltSetVolumeInformation no se puede usar para establecer la información del volumen de red. Se trata de un código de error.