IoCheckQuerySetFileInformation-Funktion (ntifs.h)
Die IoCheckQuerySetFileInformation Routine überprüft die Gültigkeit der Parameter für eine Abfrage oder einen 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 für den angegebenen Dateiinformationsvorgang erforderlichen Puffers in Bytes.
SetOperation
Boolescher Wert, der den Vorgangstyp angibt. Wenn SetOperation-TRUE-ist, handelt es sich bei dem Vorgang um einen set-Dateivorgang; wenn FALSE, es sich um einen Abfragedateivorgang handelt.
Rückgabewert
IoCheckQuerySetFileInformation gibt STATUS_SUCCESS zurück, wenn die Parameter gültig sind; andernfalls wird eine 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 in Länge angegebene Puffergröße ist kleiner als die für den angegebenen Dateivorgang erforderliche Puffergröße. |
Bemerkungen
IoCheckQuerySetFileInformation wird hauptsächlich von Netzwerkservern verwendet, die im Kernelmodus ausgeführt werden, da keine solche Überprüfung der Parametergültigkeit im normalen Pfad erfolgt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Fenster |
| Header- | ntifs.h (einschließlich Ntifs.h) |