動的なキーワード (keyword) アドレスを入力 ID で更新するために呼び出すサービス内のエントリ ポイントの関数ポインター型。
注意
この無料関数のポインター型は を介して NetFw.h発行されますが、静的リンク ライブラリは発行されません。 この関数を呼び出す 場合は、LoadLibraryExW/GetProcAddress パターンを使用します。
GetProcAddress を呼び出すときは、firewallapi.dll モジュールにハンドルを渡し、fwFreeDynamicKeywordAddressData0 を lpProcName 引数として渡します。
詳細とコード例については、「 ファイアウォールの動的キーワード」を参照してください。
構文
PFN_FWUPDATEDYNAMICKEYWORDADDRESS0 PfnFwupdatedynamickeywordaddress0;
DWORD PfnFwupdatedynamickeywordaddress0(
GUID dynamicKeywordAddressId,
PCWSTR updatedAddresses,
BOOL append
)
{...}
パラメーター
dynamicKeywordAddressId
種類: GUID
更新する動的キーワード (keyword)アドレス オブジェクトの ID。
updatedAddresses
種類: PCWSTR
オブジェクトを更新する IP アドレス、サブネット、または範囲のコンマ区切りのリスト。
append
種類: BOOL
TRUE に設定すると、updatedAddresses がオブジェクトの現在のアドレス一覧に追加されます。 FALSE に設定すると、updatedAddresses によってオブジェクトの現在のアドレス一覧が置き換えられます。
戻り値
型: DWORD
関数が成功した場合 (オブジェクトが正常に更新されました)、 ERROR_SUCCESSが返されます。 それ以外の場合は、次のいずれかの値を返します。
| 戻り値 | 説明 |
|---|---|
| ERROR_ACCESS_DENIED | 呼び出し元には、指定された ID を持つオブジェクトを操作するための適切なアクセス許可がありません。 このエラーは、MDM によって管理される AutoResolve 以外の オブジェクトでこの API が呼び出されたときに発生します。 |
| ERROR_INVALID_PARAMETER | 一般的なエラー条件は次のとおりです。指定された ID を持つオブジェクトは存在しません。アドレスの形式が無効です。 |
注釈
append が TRUE の場合、入力アドレスはオブジェクトの現在のアドレス一覧に追加されます。 入力パラメーターがオブジェクトに既に設定されているアドレスの複製である場合、そのパラメーターは破棄され、 ERROR_SUCCESS が返されます。
アドレスが動的なキーワード (keyword) アドレスの既存のアドレス フィールドの値と正確に等しい場合、ファイアウォール サービスはアドレスを重複として扱います。 重複する値は個々の要素ごとに考慮されるため、IP アドレスの一覧を使用した更新では、重複する入力のサブセットのみが破棄される可能性があります。 たとえば、動的キーワード (keyword) アドレス オブジェクトに が含まれている127.0.0.0-127.0.0.255場合、 または 127.0.0.0/24 の127.0.0.0-127.0.0.255入力はすべて破棄されます。 ただし、 などの 127.0.0.0-127.0.0.40 入力は、直接の重複ではなくサブセットであるため、破棄されません。
append が FALSE の場合、オブジェクトの現在のアドレス一覧は入力によって上書きされます。
MDM から生成された AutoResolve 以外のオブジェクトは、ERROR_ACCESS_DENIEDになります。
(API または PowerShell を使用して) ローカルに作成された AutoResolve 以外のオブジェクトは、この API を介して更新されます。
任意のオリジンの AutoResolve オブジェクトは、この API を介して更新可能です。
オブジェクトのアドレスをクリアするには、 updatedAddresses 値に NULL を渡します。
updatedAddresses パラメーターの有効な形式は、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)
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 10 ビルド 20348 |
| サポートされている最小のサーバー | Windows 10 ビルド 20348 |
| 対象プラットフォーム | Windows |
| ヘッダー | netfw.h |
| [DLL] | firewallapi.dll |