Compartir a través de


Función FltSetVolumeInformation (fltkernel.h)

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.

Comentarios

Para consultar información sobre un volumen, llame a FltQueryVolumeInformation.

Requisitos

Requisito Value
Plataforma de destino Universal
Encabezado fltkernel.h (incluya Fltkernel.h)
Library FltMgr.lib
Archivo DLL Fltmgr.sys
IRQL PASSIVE_LEVEL

Consulte también

FILE_FS_CONTROL_INFORMATION

FILE_FS_LABEL_INFORMATION

FILE_FS_OBJECTID_INFORMATION

FltQueryVolumeInformation