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) |