Função ZwSetVolumeInformationFile (ntifs.h)

Artigo
02/27/2024

A rotina ZwSetVolumeInformationFile modifica informações sobre o volume associado a um determinado arquivo, diretório, dispositivo de armazenamento ou volume.

Sintaxe

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

Manipule para um objeto de arquivo para um arquivo aberto, diretório, dispositivo de armazenamento ou volume cujas informações de volume devem ser modificadas.

[out] IoStatusBlock

Ponteiro para uma estrutura IO_STATUS_BLOCK que recebe o status de conclusão final e informações sobre a operação.

[in] FsInformation

Ponteiro para um buffer alocado pelo chamador que contém as informações de volume a serem modificadas. A estrutura das informações nesse buffer depende do valor de FsInformationClass, conforme mostrado na tabela a seguir.

[in] Length

Tamanho em bytes do buffer apontado por FsInformation. O chamador deve definir esse parâmetro de acordo com o FsInformationClass especificado.

[in] FsInformationClass

Tipo de informações de volume a serem definidas. Um dos seguintes:

Valor	Significado
FileFsControlInformation	Defina FILE_FS_CONTROL_INFORMATION para o volume.
FileFsLabelInformation	Defina FILE_FS_LABEL_INFORMATION para o volume.
FileFsObjectIdInformation	Defina FILE_FS_OBJECTID_INFORMATION para o volume.

Retornar valor

ZwSetVolumeInformationFile retorna STATUS_SUCCESS ou um valor NTSTATUS apropriado, como um dos seguintes:

Código de retorno	Descrição
STATUS_INFO_LENGTH_MISMATCH	Um valor inválido foi especificado para Length. Este é um código de erro.
STATUS_INSUFFICIENT_RESOURCES	ZwSetVolumeInformationFile encontrou uma falha de alocação de pool. Este é um código de erro.
STATUS_INVALID_INFO_CLASS	Um valor inválido foi especificado para FsInformationClass. Este é um código de erro.

Comentários

Para consultar informações de volume, chame ZwQueryVolumeInformationFile.

Para alterar informações sobre um arquivo, chame ZwSetVolumeInformationFile.

Os minifilters devem usar FltSetInformationFile em vez de ZwSetVolumeInformationFile.

Nota Se a chamada para a função ZwSetVolumeInformationFileocorrer no modo de usuário, você deverá usar o nome "NtSetInformationFile" em vez de "ZwSetVolumeInformationFile".

Para chamadas de drivers no modo kernel, as versões NtXxx e ZwXxx de uma rotina dos Serviços do Sistema Nativo do Windows podem se comportar de forma diferente na maneira como lidam e interpretam parâmetros de entrada. Para obter mais informações sobre a relação entre as versões NtXxx e ZwXxx de uma rotina, consulte Usando versões Nt e Zw das rotinas dos Serviços de Sistema Nativo.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Server 2003
Plataforma de Destino	Universal
Cabeçalho	ntifs.h (inclua Ntifs.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Regras de conformidade de DDI	HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)