FwpsOpenToken0 関数 (fwpsk.h)
FwpsOpenToken0 関数は、アクセス トークンを開きます。
注意FwpsOpenToken0 は、FwpsOpenTokenの特定のバージョンです。 詳細については、「WFP Version-Independent 名の と Windows の特定のバージョンを対象とする」を参照してください。
構文
NTSTATUS FwpsOpenToken0(
[in] IN HANDLE engineHandle,
[in] IN LUID modifiedId,
[in] IN DWORD desiredAccess,
[out] OUT HANDLE *accessToken
);
パラメーター
[in] engineHandle
フィルター エンジンへの開いているセッションのハンドル。 コールアウト ドライバーは、FwpmEngineOpen0 関数を呼び出して、フィルター エンジンへのセッションを開きます。
[in] modifiedId
トークンが変更されるたびに変更される LUID を指定します。 アプリケーションでは、セキュリティ コンテキストが最後に使用されてから変更されたかどうかをテストするために、この値を使用できます。
[in] desiredAccess
ACCESS_MASK アクセス トークンへの要求されたアクセスの種類を指定する構造体です。 これらの要求されたアクセスの種類は、トークンの随意アクセス制御リスト (DACL) と比較して、どのアクセスが許可または拒否されるかを決定します。
[out] accessToken
新しく開かれたアクセス トークンへのハンドルを受け取る呼び出し元によって割り当てられた変数へのポインター。
戻り値
FwpsOpenToken0 関数は、次のいずれかの NTSTATUS コードを返します。
リターン コード | 形容 |
---|---|
|
アクセス トークンが正常に開かれました。 |
|
エラーが発生しました。 |
備考
fwpsopentoken0 呼び出すプロセスでは、そのプロセス トークンでSE_DEBUG_NAME特権が有効になっている必要があります。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Windows 7 以降で使用できます。 |
ターゲット プラットフォーム の | 万国 |
ヘッダー | fwpsk.h (Fwpsk.h を含む) |
IRQL | <= PASSIVE_LEVEL |