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

Siehe auch

FILE_INFORMATION_CLASS

FS_INFORMATION_CLASS

IoCheckDesiredAccess

SeAccessCheck-