Función ZwSetVolumeInformationFile (ntifs.h)

Artículo
12/22/2024

El ZwSetVolumeInformationFile rutina modifica información sobre el volumen asociado a un archivo, directorio, dispositivo de almacenamiento o volumen determinado.

Sintaxis

NTSYSAPI NTSTATUS ZwSetVolumeInformationFile(
  [in]  HANDLE               FileHandle,
  [out] PIO_STATUS_BLOCK     IoStatusBlock,
  [in]  PVOID                FsInformation,
  [in]  ULONG                Length,
  [in]  FS_INFORMATION_CLASS FsInformationClass
);

Parámetros

[in] FileHandle

Controle a un objeto de archivo para un archivo abierto, directorio, dispositivo de almacenamiento o volumen cuya información de volumen se va a modificar.

[out] IoStatusBlock

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

[in] FsInformation

Puntero a un búfer asignado por el autor de la llamada que contiene la información del volumen que se va a modificar. La estructura de la información de este búfer depende del valor de FsInformationClass, como se muestra en la tabla siguiente.

[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.

[in] FsInformationClass

Tipo de información de volumen que se va a establecer. 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

ZwSetVolumeInformationFile 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	ZwSetVolumeInformationFile 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.

Observaciones

Para consultar la información del volumen, llame a ZwQueryVolumeInformationFile.

Para cambiar información sobre un archivo, llame a ZwSetVolumeInformationFile.

Los minifiltros deben usar FltSetInformationFile en lugar de ZwSetVolumeInformationFile.

Nota Si la llamada a la funciónZwSetVolumeInformationFile se produce en modo de usuario, debe usar el nombre "NtSetInformationFile" en lugar de "ZwSetVolumeInformationFile".

En el caso de las llamadas desde controladores en modo kernel, las NtXxx y Zwversiones de Xxx de una rutina de Servicios del sistema nativo de Windows pueden comportarse de forma diferente en la forma en que controlan e interpretan los parámetros de entrada. Para obtener más información sobre la relación entre las versiones de NtXxx y ZwXxx de una rutina, vea Using Nt and Zw Versions of the Native System Services Routines.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows Server 2003
de la plataforma de destino de	Universal
encabezado de	ntifs.h (incluya Ntifs.h)
biblioteca de	NtosKrnl.lib
DLL de	NtosKrnl.exe
irQL	PASSIVE_LEVEL
reglas de cumplimiento de DDI	HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)