IoCheckFunctionAccess-Funktion (ntifs.h)
Die IoCheckFunctionAccess Routine überprüft die Parameter und den Zugriff auf eine Funktion anhand des aktuellen gewährten Zugriffs auf die Datei.
Syntax
NTSTATUS IoCheckFunctionAccess(
ACCESS_MASK GrantedAccess,
UCHAR MajorFunction,
UCHAR MinorFunction,
ULONG IoControlCode,
PVOID Arg1,
PVOID Arg2
);
Parameter
GrantedAccess
Mask-Wert, der den zurzeit gewährten Zugriff auf die Datei für den Aufrufer angibt.
MajorFunction
Hauptfunktionscode für den ausgeführten Vorgang.
MinorFunction
Hilfsfunktionscode für den auszuführenden Vorgang.
IoControlCode
E/A-Funktionssteuerungscode für einen Geräte- oder Dateisystem-E/A-Code.
Arg1
Optionales Argument, das von der Hauptfunktion abhängt. Dieser Parameter verweist auf einen der FILE_INFORMATION_CLASS Enumerationswerte, wenn MajorFunction angibt, dass eine Abfrage- oder Satzdateiinformationsfunktion ausgeführt wird.
Arg2
Optionales zweites Argument, das von der Hauptfunktion abhängt. Dieser Parameter verweist auf einen der FS_INFORMATION_CLASS Enumerationswerte. Dieser Parameter muss angegeben werden, wenn MajorFunction angibt, dass eine Abfrage oder eine Dateiinformationsfunktion festgelegt wird.
Rückgabewert
IoCheckFunctionAccess gibt STATUS_SUCCESS zurück, wenn der Aufrufer Zugriff auf die Datei hat; andernfalls wird STATUS_ACCESS_DENIED zurückgegeben.
Bemerkungen
Die GrantedAccess Mask darf keine generischen Zuordnungen enthalten. Das heißt, IoCheckDesiredAccess- muss zuvor aufgerufen worden sein, um eine vollständige Maske zurückzugeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Fenster |
| Header- | ntifs.h (einschließlich Ntifs.h) |