FwpmDynamicKeywordSubscribe0 関数 (fwpmu.h)
特定の動的キーワード (keyword) アドレス (FW_DYNAMIC_KEYWORD_ADDRESS0) オブジェクトへの変更に関する通知の配信を要求します。 渡されたフラグに基づいて、アドレスのサブセットに対してのみ通知を発生させることができます。
詳細とコード例については、「 ファイアウォールの動的キーワード」を参照してください。
構文
DWORD FwpmDynamicKeywordSubscribe0(
DWORD flags,
FWPM_DYNAMIC_KEYWORD_CALLBACK0 callback,
void *context,
HANDLE *subscriptionHandle
);
パラメーター
flags
型: _In_ DWORD
では、次の fwpmu.hフラグが定義されています。
FWPM_NOTIFY_ADDRESSES_AUTO_RESOLVE は、 FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVE フラグが設定されているオブジェクトに対してのみ通知が配信されることを示します。
FWPM_NOTIFY_ADDRESSES_NON_AUTO_RESOLVEは、FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVE フラグが設定されていないオブジェクトに対してのみ通知が配信されることを示します。
FWPM_NOTIFY_ADDRESSES_AUTO_RESOLVEは、すべての動的キーワード (keyword)アドレス オブジェクトに対して通知が配信されることを示します。
callback
型: _In_ FWPM_DYNAMIC_KEYWORD_CALLBACK0
実装するコールバック関数へのポインター。通知を配信する準備ができたときに呼び出されます。
context
型: _In_opt_ void*
省略可能なコンテキスト ポインター。 このポインターはコールバック関数に渡されます。
subscriptionHandle
型: _Out_ HANDLE*
ハンドルのアドレス。新しく作成されたサブスクリプションへのハンドルが設定されます。
戻り値
型: DWORD
関数が成功した場合は、 ERROR_SUCCESSを返します。 それ以外の場合は、次のいずれかの値を返します。
| 戻り値 | 説明 |
|---|---|
| ERROR_INVALID_PARAMETER | flags 値は 0 です。 |
注釈
AutoResolve 動的キーワード (keyword) アドレスの通知は、オブジェクトが追加または削除されたときに配信されます。
AutoResolve 以外の動的キーワード (keyword) アドレスの通知は、オブジェクトが追加、削除、または更新されたときに配信されます。
コールバック関数にデータは提供されません。 システムで何が変更されたかに関する情報が必要な場合は、 列挙 API を使用できます。
サブスクリプションが不要になったらハンドルを閉じる必要があります。 これを行うには、 FwpmDynamicKeywordUnsubscribe0 関数を 呼び出す必要があります。
FWPM_DYNAMIC_KEYWORD_CALLBACK0の実装は、ThreadPool スレッドでスケジュールされ、他の待機操作に影響を与える可能性があるため、動的なキーワード (keyword) アドレス オブジェクトの変更に迅速に対応する必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 10 ビルド 20348 |
| サポートされている最小のサーバー | Windows 10 ビルド 20348 |
| 対象プラットフォーム | Windows |
| ヘッダー | fwpmu.h |
| Library | Fwpuclnt.lib |
| [DLL] | Fwpuclnt.dll |