Função ZwSetVolumeInformationFile (ntifs.h)

Artigo
12/21/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 de 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 oFsInformationClass determinado.

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

Valor de retorno

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.

Observações

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

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

Os minifiltros devem usar FltSetInformationFile em vez de ZwSetVolumeInformationFile .

Observação Se a chamada para a funçãoZwSetVolumeInformationFile ocorrer 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 versões de uma rotina dos Serviços de 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 de serviços do sistema nativo.

Requisitos

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