Función ZwSetVolumeInformationFile (ntifs.h)

Artículo
02/29/2024

La rutina ZwSetVolumeInformationFile modifica la 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

Identificador de un objeto de archivo para un archivo abierto, un directorio, un dispositivo de almacenamiento o un 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 Length. 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.

Comentarios

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

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

Los minifiltros deben usar FltSetInformationFile en lugar de ZwSetVolumeInformationFile.

Nota Si la llamada a la función ZwSetVolumeInformationFilese 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 versiones NtXxx y ZwXxx de una rutina de Windows Native System Services 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 NtXxx y ZwXxx de una rutina, vea Using Nt and Zw Versions of the Native System Services Routines.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Server 2003
Plataforma de destino	Universal
Encabezado	ntifs.h (incluya Ntifs.h)
Library	NtosKrnl.lib
Archivo DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Reglas de cumplimiento de DDI	HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)