FwpmEngineOpen0 関数 (fwpmk.h)

  • [アーティクル]

FwpmEngineOpen0 関数は、フィルター エンジンへのセッションを開きます。

構文

NTSTATUS FwpmEngineOpen0(
  [in, optional] const wchar_t             *serverName,
  [in]           UINT32                    authnService,
  [in, optional] SEC_WINNT_AUTH_IDENTITY_W *authIdentity,
  [in, optional] const FWPM_SESSION0       *session,
  [out]          HANDLE                    *engineHandle
);

パラメーター

[in, optional] serverName

フィルター エンジンへのセッションを開くシステムの標準 DNS 名を指定する NULL で終わる文字列へのポインター。 コールアウト ドライバーでは、このパラメーター NULL を指定する必要があります。

[in] authnService

使用する認証サービス。 このパラメーターの有効な選択肢の一覧については、Microsoft Windows SDK ドキュメントの RPC セクションの Authentication-Service 定数を参照してください。 吹き出しドライバーは、このパラメーターにRPC_C_AUTHN_WINNTまたはRPC_C_AUTHN_DEFAULTを指定する必要があります。

[in, optional] authIdentity

フィルター エンジンにアクセスするための認証資格情報と承認資格情報を含む SEC_WINNT_AUTH_IDENTITY_W 構造体へのポインター。 このパラメーターは、FwpmEngineOpen0 関数がコールアウト ドライバーから呼び出されたときに無視されます。 コールアウト ドライバーは、このパラメーターを NULL設定する必要があります。

[in, optional] session

開くセッションのセッション固有のパラメーターを定義する FWPM_SESSION0 構造体へのポインター。 このポインターは省略可能であり、NULLできます。

[out] engineHandle

フィルター エンジンへの開いているセッションのハンドルを受け取る変数へのポインター。

戻り値

FwpmEngineOpen0 関数は、次のいずれかの NTSTATUS コードを返します。

リターン コード 形容
STATUS_SUCCESS フィルター エンジンへのセッションが正常に開かれました。 engineHandle パラメーターが指す変数には、開いているセッションのハンドルが含まれています。
その他の NTSTATUS コード エラーが発生しました。

備考

コールアウト ドライバーは、FwpmEngineOpen0 関数を呼び出して、フィルター エンジンへのセッションを開きます。 フィルター エンジンへの開いているセッションへのハンドルは、Windows フィルター プラットフォーム管理機能のほとんどのに必要なパラメーターです。

吹き出しドライバーは通常、Windows フィルター プラットフォームの 管理機能を呼び出さないので、通常、フィルター エンジンへのセッションを開く必要はありません。

コールアウト ドライバーがフィルター エンジンへのセッションを正常に開くには、コールアウト ドライバーが FwpmEngineOpen0 関数を呼び出した時点で、フィルター エンジンが現在実行中である必要があります。 コールアウト ドライバーは、FwpmBfeStateGet0 関数を呼び出して、フィルター エンジンの現在の状態を取得できます。 FwpmBfeStateGet0呼び出す前に、コールアウト ドライバーは FwpmBfeStateSubscribeChanges0 関数を呼び出して、フィルター エンジンの状態が変化するたびに呼び出されるコールバック関数を登録する必要があります。

コールアウト ドライバーは、フィルター エンジンへのアクセスを完了した後、FwpmEngineClose0 関数を呼び出して、フィルター エンジンへの開いているセッションを閉じます。

FwpmEngineOpen0 は、FwpmEngineOpenの特定のバージョンです。 詳細については、「WFP Version-Independent 名の と Windows の特定のバージョンを対象とする」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows Vista 以降で使用できます。
ターゲット プラットフォーム の 万国
ヘッダー fwpmk.h (Fwpmk.h を含む)
ライブラリ Fwpkclnt.lib
IRQL PASSIVE_LEVEL

関連項目