Funzione IoCheckQuerySetFileInformation (ntifs.h)

La routine IoCheckQuerySetFileInformation controlla la validità dei parametri per un'operazione di query o impostazione delle informazioni sui file.

Sintassi

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

Parametri

FileInformationClass

Valore di enumerazione FILE_INFORMATION_CLASS che specifica la classe di informazioni sul file da controllare.

Length

Dimensioni, in byte, del buffer necessario per l'operazione di informazioni sui file specificata.

SetOperation

Valore booleano che specifica il tipo di operazione. Se SetOperation è TRUE, l'operazione è un'operazione di file impostata; se FALSE, si tratta di un'operazione del file di query.

Valore restituito

IoCheckQuerySetFileInformation restituisce STATUS_SUCCESS se i parametri sono validi; in caso contrario, restituisce uno dei codici di errore seguenti.

Codice restituito Descrizione
STATUS_INVALID_INFO_CLASS Il valore specificato in FileInformationClass non è una classe di informazioni valida.
STATUS_INFO_LENGTH_MISMATCH Le dimensioni del buffer specificate in Length sono inferiori alle dimensioni del buffer necessarie per l'operazione di file specificata.

Commenti

IoCheckQuerySetFileInformation viene usato principalmente dai server di rete in esecuzione in modalità kernel perché non viene eseguito alcun controllo di validità di tale parametro nel percorso normale.

Requisiti

Requisito Valore
Piattaforma di destinazione Windows
Intestazione ntifs.h (include Ntifs.h)

Vedi anche

FILE_INFORMATION_CLASS

ZwQueryInformationFile

ZwSetInformationFile