Función FltSetVolumeInformation (fltkernel.h)

FltSetVolumeInformation cambia varios tipos de información sobre el volumen al que está asociada la instancia dada.

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 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 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 Longitud. 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	El de instancia de está conectado 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.

Observaciones

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

Requisitos

Requisito	Valor
de la plataforma de destino de	Universal
encabezado de	fltkernel.h (incluya Fltkernel.h)
biblioteca de	FltMgr.lib
DLL de	Fltmgr.sys
irQL	PASSIVE_LEVEL

Consulte también

FILE_FS_CONTROL_INFORMATION

FILE_FS_LABEL_INFORMATION

FILE_FS_OBJECTID_INFORMATION

FltQueryVolumeInformation