次の方法で共有

FwpmEngineGetOption0 関数 (fwpmk.h)

  • [アーティクル]

FwpmEngineGetOption0 関数は、フィルター エンジン オプションを取得します。

構文

NTSTATUS FwpmEngineGetOption0(
  [in]  HANDLE             engineHandle,
  [in]  FWPM_ENGINE_OPTION option,
  [out] FWP_VALUE0         **value
);

パラメーター

[in] engineHandle

フィルター エンジンへの開いているセッションのハンドル。 FwpmEngineOpen0 を呼び出して、フィルター エンジンへのセッションを開きます。

[in] option

取得するオプション。

[out] value

オプション値。 value パラメーターに含まれるデータ型は FWP_UINT32されます。

オプションが FWPM_ENGINE_COLLECT_NET_EVENTS場合、値は次のいずれかになります。

価値 意味
0 ネットワーク イベントが収集されていません。
1 ネットワーク イベントが収集されています。

オプション FWPM_ENGINE_NET_EVENT_MATCH_ANY_KEYWORDS場合、値 は、次の値のビットごとの組み合わせになります。

価値 意味
FWPM_NET_EVENT_KEYWORD_INBOUND_MCAST (1) 受信マルチキャスト ネットワーク イベントが収集されています。
FWPM_NET_EVENT_KEYWORD_INBOUND_BCAST (2) 受信ブロードキャスト ネットワーク イベントが収集されていません。

オプション が FWPM_ENGINE_PACKET_QUEUING されている場合 (Windows 8 および Windows Server 2012 でのみ使用できます)、値 は次のいずれかになります。

価値 意味
FWPM_ENGINE_OPTION_PACKET_QUEUE_NONE (0) パケット キューが有効になっていません。
FWPM_ENGINE_OPTION_PACKET_QUEUE_INBOUND (1) 受信パケット キューが有効になっています。
FWPM_ENGINE_OPTION_PACKET_QUEUE_OUTBOUND (2) 送信パケット キューが有効になっています。

オプション が FWPM_ENGINE_MONITOR_IPSEC_CONNECTIONS されている場合 (Windows 8 および Windows Server 2012 でのみ使用できます)、値 は次のいずれかになります。

価値 意味
0 IPsec 接続の監視機能が無効になっています。 IPsec 接続イベントまたは通知がログに記録されていません。
1 IPsec 接続監視機能が有効になっています。 新しい IPsec 接続イベントと通知がログに記録されます。

オプション が FWPM_ENGINE_TXN_WATCHDOG_TIMEOUT_IN_MSEC されている場合 (Windows 8 および Windows Server 2012 でのみ使用可能)、値 は、1 つの WFP トランザクションの最大期間を指定する時間 (ミリ秒単位) になります。 この期間を超えるトランザクションでは、ウォッチドッグ イベントがトリガーされます。

FWPM_ENGINE_NAME_CACHE オプションは、内部使用のために予約されています。

戻り値

戻りコード/値 形容
ERROR_SUCCESS 0 オプションが正常に取得されました。
FWP_E_* エラー コードの 0x80320001 - 0x80320039 Windows フィルタリング プラットフォーム (WFP) 固有のエラー。 詳細については、「WFP エラー コードの」を参照してください。
RPC_* エラー コードの 0x80010001 - 0x80010122 リモートまたはローカルのファイアウォール エンジンとの通信に失敗しました。
その他の NTSTATUS コード エラーが発生しました。

備考

呼び出し元は、fwpmFreeMemory0呼び出しによって返されたオブジェクトを解放する必要があります。

呼び出し元は、フィルター エンジン FWPM_ACTRL_READ アクセスする必要があります。 詳細については、「アクセス制御の」を参照してください。

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

必要条件

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

関連項目