Compartir a través de


Función ZwSetVolumeInformationFile (ntifs.h)

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)

Consulte también

FILE_FS_CONTROL_INFORMATION

FILE_FS_LABEL_INFORMATION

FILE_FS_OBJECTID_INFORMATION

FltSetInformationFile

IRP_MJ_SET_VOLUME_INFORMATION

Uso de las versiones Nt y Zw de las rutinas nativas de System Services

ZwQueryVolumeInformationFile

ZwSetInformationFile