IoCheckFunctionAccess 函式 (ntifs.h)

  • 發行項

IoCheckFunctionAccess 例程會根據目前授與的檔案存取權，檢查函式的參數和存取權。

語法

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

參數

GrantedAccess

遮罩值，指定目前授與給呼叫端檔案的存取權。

MajorFunction

正在執行的作業的主要函式程序代碼。

MinorFunction

正在執行的作業的次要函式程序代碼。

IoControlCode

裝置或檔案系統 I/O 程式代碼的 I/O 函式控制程式代碼。

Arg1

相依於主要函式的選擇性自變數。 如果MajorFunction指出正在執行查詢或設定檔案資訊函式，此參數會指向其中一個FILE_INFORMATION_CLASS列舉值。

Arg2

相依於主要函式的選擇性第二個自變數。 此參數指向其中一個 FS_INFORMATION_CLASS 列舉值。 如果 MajorFunction 指出正在執行查詢或配置檔案資訊函式，則必須提供此參數。

傳回值

如果呼叫端具有檔案的存取權，IoCheckFunctionAccess 會傳回STATUS_SUCCESS;否則會傳回STATUS_ACCESS_DENIED。

備註

GrantedAccess 遮罩不能包含任何泛型對應。 也就是說，先前必須叫用 IoCheckDesiredAccess 才能傳回完整遮罩。

規格需求

需求 值
目標平台 Windows
標頭 ntifs.h (包含 Ntifs.h)

另請參閱

FILE_INFORMATION_CLASS

FS_INFORMATION_CLASS

IoCheckDesiredAccess

SeAccessCheck