Função IoCheckQuerySetFileInformation (ntifs.h)

  • Artigo

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

Sintaxe

NTSTATUS IoCheckQuerySetFileInformation(
  FILE_INFORMATION_CLASS FileInformationClass,
  ULONG                  Length,
  BOOLEAN                SetOperation
);

Parâmetros

FileInformationClass

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

Length

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

SetOperation

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

Retornar valor

IoCheckQuerySetFileInformation 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 FileInformationClass 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 arquivo especificada.

Comentários

IoCheckQuerySetFileInformation é 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

FILE_INFORMATION_CLASS

ZwQueryInformationFile

ZwSetInformationFile