Win32 API 日本語リファレンス
ホーム › NetworkManagement.WindowsFirewall › PFN_FWENUMDYNAMICKEYWORDADDRESSESBYTYPE0

PFN_FWENUMDYNAMICKEYWORDADDRESSESBYTYPE0

コールバック

シグネチャ

DWORD PFN_FWENUMDYNAMICKEYWORDADDRESSESBYTYPE0(
    DWORD flags,
    FW_DYNAMIC_KEYWORD_ADDRESS_DATA0** dynamicKeywordAddressData
);

パラメーター

フィールド型説明
flagsDWORD

値 FW_DYNAMIC_KEYWORD_ADDRESS_ENUM_FLAGS_AUTO_RESOLVE を使用すると、FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVE フラグが設定されているすべてのオブジェクトを列挙します。

値 FW_DYNAMIC_KEYWORD_ADDRESS_ENUM_FLAGS_NON_AUTO_RESOLVE を使用すると、FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVE フラグが設定されていないすべてのオブジェクトを列挙します。

値 FW_DYNAMIC_KEYWORD_ADDRESS_ENUM_FLAGS_NON_AUTO_RESOLVE を使用すると、すべてのオブジェクトを列挙します。

dynamicKeywordAddressDataFW_DYNAMIC_KEYWORD_ADDRESS_DATA0**動的キーワードアドレスオブジェクトへのポインターのアドレス。返されたオブジェクトの連結リストを保持します。このアドレスは、FWFreeDynamicKeywordAddressData0 を呼び出して解放する必要があります。

公式ドキュメント

動的キーワードアドレスを種類別に列挙するために呼び出す、サービス内のエントリポイントの関数ポインター型。渡された列挙フラグに基づいて、オブジェクトの特定のサブセットを要求できます。

メモ

このフリー関数のポインター型は NetFw.h を通じて公開されていますが、静的リンクライブラリは公開されていません。この関数を呼び出すには、LoadLibraryExW/GetProcAddress のパターンを使用してください。

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

詳細情報とコード例については、Firewall dynamic keywords を参照してください。

戻り値

型: DWORD

関数が成功した場合は ERROR_SUCCESS を返します。それ以外の場合は、次のいずれかの値を返します。

戻り値 説明
ERROR_INVALID_PARAMETER flags パラメーターに 0 の値が渡されました。

解説(Remarks)

リスト内で最初に返されたオブジェクト(リストの先頭)のアドレスは、FWFreeDynamicKeywordAddressData0 を呼び出して解放する必要があります。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)