次の方法で共有

PFN_FWADDDYNAMICKEYWORDADDRESS0 コールバック関数 (netfw.h)

  • [アーティクル]

指定した動的キーワード (keyword) アドレスを追加するために呼び出すサービス内のエントリ ポイントの関数ポインター型。

注意

この無料関数のポインター型は を介して NetFw.h発行されますが、静的リンク ライブラリは発行されません。 この関数を呼び出す 場合は、LoadLibraryExW/GetProcAddress パターンを使用します。

GetProcAddress を呼び出すときは、firewallapi.dll モジュールにハンドルを渡し、fwAddDynamicKeywordAddress0 を lpProcName 引数として渡します。

詳細とコード例については、「 ファイアウォールの動的キーワード」を参照してください。

構文

PFN_FWADDDYNAMICKEYWORDADDRESS0 PfnFwadddynamickeywordaddress0;

DWORD PfnFwadddynamickeywordaddress0(
  const PFW_DYNAMIC_KEYWORD_ADDRESS0 dynamicKeywordAddress
)
{...}

パラメーター

dynamicKeywordAddress

型: const PFW_DYNAMIC_KEYWORD_ADDRESS0

定数 (設定済み) の動的キーワード (keyword)アドレス オブジェクトへのポインター。

戻り値

型: DWORD

関数が成功した場合 (オブジェクトが正常に作成され、追加されました)、 ERROR_SUCCESSが返されます。 それ以外の場合は、次のいずれかの値を返します。

戻り値 説明
ERROR_ACCESS_DENIED 呼び出し元には、このオブジェクトを作成するための適切なアクセス許可がありません。
ERROR_ALREADY_EXISTS 指定した ID を持つオブジェクトは、システム上に既に存在します。
ERROR_INVALID_PARAMETER 無効なFW_DYNAMIC_KEYWORD_ADDRESS0。 有効な使用方法については 、「解説 」を参照してください。

解説

  • FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVE フラグが設定されている場合は、次のようになります。
    • アドレスは NULL である必要があります。
    • キーワード (keyword) フィールドは、解決できる文字列 (FQDN またはホスト名) である必要があります。
  • FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVE フラグが設定されていない場合、addresses フィールドは IP アドレス トークンのコンマ区切りのリストである必要があります。 トークンには、個々の IP アドレス、範囲、またはサブネットを指定できます。 有効なトークン形式は次のとおりです。
    • 有効な IPv4 アドレス (10.0.0.10 など)
    • 有効な IPv6 アドレス (2620:1ec:c11::200 など)
    • スペースを含まない開始アドレスの形式<の IPv4 アドレス><>範囲 (例: 10.0.0.0-10.0.0.255)
    • スペースを含まない開始アドレスの>アドレス><範囲 (例: 2001:db8:abcd:12::-2001:db8:abcd:12:ffff:ffff:ffff:ffff) の形式<の IPv6 アドレス範囲
    • ネットワーク プレフィックス表記を使用して指定された有効な IPv4 サブネット (10.0.0.0/24 など)
    • プレフィックス長表記を使用して指定された有効な IPv6 サブネット (例: 2001:db8:abcd:0012::0/64)
  • 動的なキーワード (keyword) アドレスは、再起動後も保持されます。 AutoResolved オブジェクトの場合、アドレスはブート サイクル間で保持されないため、次のブート サイクル中に再評価する必要があります。

要件

   
サポートされている最小のクライアント Windows 10 ビルド 20348
サポートされている最小のサーバー Windows 10 ビルド 20348
対象プラットフォーム Windows
ヘッダー netfw.h
[DLL] firewallapi.dll

関連項目