Função IoCheckQuerySetVolumeInformation (ntifs.h)

  • Artigo

A rotina IoCheckQuerySetVolumeInformation verifica a validade dos parâmetros para uma consulta ou definir a operação de informações de volume.

Sintaxe

NTSTATUS IoCheckQuerySetVolumeInformation(
  FS_INFORMATION_CLASS FsInformationClass,
  ULONG                Length,
  BOOLEAN              SetOperation
);

Parâmetros

FsInformationClass

Um FS_INFORMATION_CLASS valor de enumeração que especifica a classe de informações a ser verificada.

Length

Tamanho, em bytes, do buffer necessário para a operação de informações especificada.

SetOperation

Valor booliano que especifica o tipo de operação. Se SetOperation for TRUE, a operação será uma operação de volume definida; se FALSE, é uma operação de volume de consulta.

Retornar valor

IoCheckQuerySetVolumeInformation retornará STATUS_SUCCESS se os parâmetros forem válidos; caso contrário, ele retornará um dos seguintes códigos de erro.

Código de retorno Descrição
STATUS_INVALID_INFO_CLASS O valor especificado em FsInformationClass não é uma classe de informações válida.
STATUS_INFO_LENGTH_MISMATCH O tamanho do buffer especificado em Length é menor do que o tamanho do buffer necessário para a operação de volume especificada.

Comentários

IoCheckQuerySetVolumeInformation é usado principalmente por servidores de rede em execução no modo kernel, pois nenhuma verificação de validade desse parâmetro é feita no caminho normal.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho ntifs.h (inclua Ntifs.h)

Confira também

FS_INFORMATION_CLASS

ZwQueryVolumeInformationFile

ZwSetVolumeInformationFile