Função IoCheckQuerySetFileInformation (ntifs.h)
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) |