IoCheckQuerySetFileInformation-Funktion (ntifs.h)
Die IoCheckQuerySetFileInformation-Routine überprüft die Gültigkeit der Parameter für einen Abfrage- oder Dateiinformationsvorgang.
Syntax
NTSTATUS IoCheckQuerySetFileInformation(
FILE_INFORMATION_CLASS FileInformationClass,
ULONG Length,
BOOLEAN SetOperation
);
Parameter
FileInformationClass
Ein FILE_INFORMATION_CLASS Enumerationswert, der die zu überprüfende Dateiinformationsklasse angibt.
Length
Größe des Puffers in Bytes, der für den angegebenen Dateiinformationsvorgang erforderlich ist.
SetOperation
Boolescher Wert, der den Vorgangstyp angibt. Wenn SetOperationauf TRUE festgelegt ist, ist der Vorgang ein Dateisatzvorgang. Wenn FALSE, handelt es sich um einen Abfragedateivorgang.
Rückgabewert
IoCheckQuerySetFileInformation gibt STATUS_SUCCESS zurück, wenn die Parameter gültig sind. Andernfalls wird einer der folgenden Fehlercodes zurückgegeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
| STATUS_INVALID_INFO_CLASS | Der in FileInformationClass angegebene Wert ist keine gültige Informationsklasse. |
| STATUS_INFO_LENGTH_MISMATCH | Die unter Länge angegebene Puffergröße ist kleiner als die puffergröße, die für den angegebenen Dateivorgang erforderlich ist. |
Hinweise
IoCheckQuerySetFileInformation wird in erster Linie von Netzwerkservern verwendet, die im Kernelmodus ausgeführt werden, da keine solche Überprüfung der Parametergültigkeit im normalen Pfad durchgeführt wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | ntifs.h (include Ntifs.h) |