IoCheckFunctionAccess-Funktion (ntifs.h)

Artikel
02/27/2024

Die IoCheckFunctionAccess-Routine überprüft die Parameter und den Zugriff für eine Funktion anhand des aktuell gewährten Zugriffs auf die Datei.

Syntax

NTSTATUS IoCheckFunctionAccess(
  ACCESS_MASK GrantedAccess,
  UCHAR       MajorFunction,
  UCHAR       MinorFunction,
  ULONG       IoControlCode,
  PVOID       Arg1,
  PVOID       Arg2
);

Parameter

GrantedAccess

Maskierungswert, der den derzeit für den Aufrufer gewährten Zugriff auf die Datei angibt.

MajorFunction

Hauptfunktionscode für den ausgeführten Vorgang.

MinorFunction

Nebenfunktionscode für den ausgeführten Vorgang.

IoControlCode

E/A-Funktionssteuerungscode für einen E/A-Code eines Geräts oder Dateisystems.

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 Set-Dateiinformationsfunktion 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 Einstellungsfunktion für Dateiinformationen ausgeführt wird.

Rückgabewert

IoCheckFunctionAccess gibt STATUS_SUCCESS zurück, wenn der Aufrufer Zugriff auf die Datei hat. Andernfalls wird STATUS_ACCESS_DENIED zurückgegeben.

Hinweise

Die GrantedAccess-Maske kann keine generischen Zuordnungen enthalten. Das heißt, IoCheckDesiredAccess muss zuvor aufgerufen worden sein, um eine vollständige Maske zurückzugeben.