ホーム › NetworkManagement.WindowsFirewall › PFN_FWADDDYNAMICKEYWORDADDRESS0
PFN_FWADDDYNAMICKEYWORDADDRESS0
コールバックシグネチャ
DWORD PFN_FWADDDYNAMICKEYWORDADDRESS0(
FW_DYNAMIC_KEYWORD_ADDRESS0* dynamicKeywordAddress
);パラメーター
| フィールド | 型 | 説明 |
|---|---|---|
| dynamicKeywordAddress | FW_DYNAMIC_KEYWORD_ADDRESS0* | 定数の(値が設定済みの)動的キーワードアドレスオブジェクトへのポインター。 |
公式ドキュメント
指定された動的キーワードアドレスを追加するために呼び出す、サービス内のエントリポイントの関数ポインター型。
メモ
このフリー関数のポインター型は NetFw.h を通じて公開されていますが、静的リンクライブラリは公開されていません。この関数を呼び出すには、LoadLibraryExW/GetProcAddress のパターンを使用してください。
GetProcAddress を呼び出すときは、firewallapi.dll モジュールのハンドルを渡し、lpProcName 引数には FWAddDynamicKeywordAddress0 を渡します。
詳細情報とコード例については、Firewall dynamic keywords を参照してください。
戻り値
型: DWORD
関数が成功した場合(オブジェクトが正常に作成され、追加された場合)は ERROR_SUCCESS を返します。それ以外の場合は、次のいずれかの値を返します。
| 戻り値 | 説明 |
|---|---|
| ERROR_ACCESS_DENIED | 呼び出し元が、このオブジェクトを作成するための適切なアクセス許可を持っていません。 |
| ERROR_ALREADY_EXISTS | 指定された ID を持つオブジェクトが、システム上に既に存在します。 |
| ERROR_INVALID_PARAMETER | FW_DYNAMIC_KEYWORD_ADDRESS0 が無効です。有効な使用方法については 解説 を参照してください。 |
解説(Remarks)
- FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVE フラグが設定されている場合は、次のとおりです。
- addresses は 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)
- <開始アドレス>-<終了アドレス> の形式(空白を含まない)で指定した IPv6 アドレス範囲(例: 2001:db8:abcd:12::-2001:db8:abcd:12:ffff:ffff:ffff:ffff)
- ネットワークプレフィックス表記で指定した有効な IPv4 サブネット(例: 10.0.0.0/24)
- プレフィックス長表記で指定した有効な IPv6 サブネット(例: 2001:db8:abcd:0012::0/64)
- 動的キーワードアドレスは再起動後も保持されます。AutoResolved オブジェクトの場合、アドレスは起動サイクルをまたいで保持されないため、次の起動サイクル中に再評価する必要があります。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)