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 列挙値の 1 つを指します。
Arg2
メジャー関数に依存する省略可能な 2 番目の引数。 このパラメーターは、FS_INFORMATION_CLASS 列挙値のいずれかを指します。 MajorFunction クエリまたはセット ファイル情報関数が実行されていることを示す場合は、このパラメーターを指定する必要があります。
戻り値
IoCheckFunctionAccess は、呼び出し元がファイルにアクセスできる場合にSTATUS_SUCCESSを返します。それ以外の場合は、STATUS_ACCESS_DENIEDを返します。
備考
GrantedAccess マスクには、ジェネリック マッピングを含めることはできません。 つまり、IoCheckDesiredAccess は、完全なマスクを返すために以前に呼び出されている必要があります。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | ウィンドウズ |
| ヘッダー | ntifs.h (Ntifs.h を含む) |