Função IoCheckQuerySetFileInformation (ntifs.h)
A rotina IoCheckQuerySetFileInformation verifica a validade dos parâmetros para uma consulta ou uma operação de informações de arquivo definida.
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 do 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.
Valor de retorno
IoCheckQuerySetFileInformation retornará STATUS_SUCCESS se os parâmetros forem válidos; caso contrário, ele retorna 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 no Length é menor do que o tamanho do buffer necessário para a operação de arquivo especificada. |
Observações
IoCheckQuerySetFileInformation é usado principalmente por servidores de rede em execução no modo kernel, já que nenhuma verificação de validade desse parâmetro é feita no caminho normal.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Windows |
| cabeçalho | ntifs.h (inclua Ntifs.h) |