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

INetFwProfile

COMIDispatch (デュアル)
📘 Microsoft Learn (日本語) · English
✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。
IID174a0dda-e9f9-449d-993b-21ab667ca456継承元IDispatch呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl7

公式ドキュメント

INetFwProfile インターフェイスは、ファイアウォール設定のプロファイルへのアクセスを提供します。

解説(Remarks)

このインターフェイスのインスタンスは、 INetFwPolicy インターフェイスの CurrentProfile プロパティまたは GetProfileByType メソッドを通じて取得します。

すべての構成変更は 即座に有効になります。

メソッド 14

vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。

vtbl 7 HRESULT get_Type(NET_FW_PROFILE_TYPE* type)

プロファイルの種類を指定します。

typeNET_FW_PROFILE_TYPE*outこのプロファイルの種類を表す NET_FW_PROFILE_TYPE 値を受け取るポインタである。
vtbl 8 HRESULT get_FirewallEnabled(VARIANT_BOOL* enabled)

ファイアウォールが有効かどうかを示します。(Get)

enabledVARIANT_BOOL*outこのプロファイルでファイアウォールが有効かどうかを示す VARIANT_BOOL 値を受け取るポインタである。

解説(Remarks)

得られるファイアウォールの状態は、ローカルストアのローカルポリシーに基づきます。全体的な動作状態を判断するには、Checking the Effective Firewall Status の手順を使用してください。

vtbl 9 HRESULT put_FirewallEnabled(VARIANT_BOOL enabled)

ファイアウォールが有効かどうかを示します。(Put)

enabledVARIANT_BOOLinこのプロファイルでファイアウォールを有効にするかどうかを示す VARIANT_BOOL 値を指定する。

解説(Remarks)

得られるファイアウォールの状態は、ローカルストアのローカルポリシーに基づきます。全体的な動作状態を判断するには、Checking the Effective Firewall Status の手順を使用してください。

vtbl 10 HRESULT get_ExceptionsNotAllowed(VARIANT_BOOL* notAllowed)

ファイアウォールが例外を許可しないかどうかを示します。(Get)

notAllowedVARIANT_BOOL*out例外を許可しない (すべての受信トラフィックをブロックする) 設定が有効かどうかを示す VARIANT_BOOL 値を受け取るポインタである。

解説(Remarks)

すべてのインターフェイスがファイアウォールで保護されます。つまり、プロファイルで指定された GloballyOpenPorts、Applications、Services などのすべての例外は無視され、 ローカルから開始されたトラフィックのみが許可されます。

得られるファイアウォールの状態は、2 つのレベルの組み合わせによって決まります。まずグローバルな動作モードを確認し、次に対象となるインターフェイスのモードを確認します。全体的な動作状態を判断するには、Checking the Effective Firewall Status の手順を使用してください。

vtbl 11 HRESULT put_ExceptionsNotAllowed(VARIANT_BOOL notAllowed)

ファイアウォールが例外を許可しないかどうかを示します。(Put)

notAllowedVARIANT_BOOLin例外を許可しない設定を有効にするかどうかを示す VARIANT_BOOL 値を指定する。

解説(Remarks)

すべてのインターフェイスがファイアウォールで保護されます。つまり、プロファイルで指定された GloballyOpenPorts、Applications、Services などのすべての例外は無視され、 ローカルから開始されたトラフィックのみが許可されます。

得られるファイアウォールの状態は、2 つのレベルの組み合わせによって決まります。まずグローバルな動作モードを確認し、次に対象となるインターフェイスのモードを確認します。全体的な動作状態を判断するには、Checking the Effective Firewall Status の手順を使用してください。

vtbl 12 HRESULT get_NotificationsDisabled(VARIANT_BOOL* disabled)

対話型のファイアウォール通知が無効かどうかを示します。(INetFwProfile.get_NotificationsDisabled)

disabledVARIANT_BOOL*outプログラムがブロックされた際の通知が無効かどうかを示す VARIANT_BOOL 値を受け取るポインタである。
vtbl 13 HRESULT put_NotificationsDisabled(VARIANT_BOOL disabled)

対話型のファイアウォール通知が無効かどうかを示します。(INetFwProfile.put_NotificationsDisabled)

disabledVARIANT_BOOLinプログラムがブロックされた際の通知を無効にするかどうかを示す VARIANT_BOOL 値を指定する。
vtbl 14 HRESULT get_UnicastResponsesToMulticastBroadcastDisabled(VARIANT_BOOL* disabled)

ファイアウォールがマルチキャストおよびブロードキャストのトラフィックに対するユニキャスト応答を許可しないかどうかを示します。(INetFwProfile.get_UnicastResponsesToMulticastBroadcastDisabled)

disabledVARIANT_BOOL*outマルチキャストまたはブロードキャストに対するユニキャスト応答が無効かどうかを示す VARIANT_BOOL 値を受け取るポインタである。

解説(Remarks)

PC がブロードキャストパケットを送信した場合、3 秒間ユニキャスト応答が許可されます。この動作を変更するには、このプロパティを使用します。

vtbl 15 HRESULT put_UnicastResponsesToMulticastBroadcastDisabled(VARIANT_BOOL disabled)

ファイアウォールがマルチキャストおよびブロードキャストのトラフィックに対するユニキャスト応答を許可しないかどうかを示します。(INetFwProfile.put_UnicastResponsesToMulticastBroadcastDisabled)

disabledVARIANT_BOOLinマルチキャストまたはブロードキャストに対するユニキャスト応答を無効にするかどうかを示す VARIANT_BOOL 値を指定する。

解説(Remarks)

PC がブロードキャストパケットを送信した場合、3 秒間ユニキャスト応答が許可されます。この動作を変更するには、このプロパティを使用します。

vtbl 16 HRESULT get_RemoteAdminSettings(INetFwRemoteAdminSettings** remoteAdminSettings)

リモート管理を制御する設定を指定します。

remoteAdminSettingsINetFwRemoteAdminSettings**outリモート管理の設定を表す INetFwRemoteAdminSettings インターフェイスを受け取るポインタである。
vtbl 17 HRESULT get_IcmpSettings(INetFwIcmpSettings** icmpSettings)

プロファイルの ICMP 設定を取得します。

icmpSettingsINetFwIcmpSettings**outICMP の設定を表す INetFwIcmpSettings インターフェイスを受け取るポインタである。
vtbl 18 HRESULT get_GloballyOpenPorts(INetFwOpenPorts** openPorts)

プロファイルのグローバルに開かれたポートのコレクションを取得します。

openPortsINetFwOpenPorts**outグローバルに開放されたポートのコレクションを表す INetFwOpenPorts インターフェイスを受け取るポインタである。
vtbl 19 HRESULT get_Services(INetFwServices** services)

プロファイルのサービスのコレクションを取得します。

servicesINetFwServices**outファイアウォールが認識する標準サービスのコレクションを表す INetFwServices インターフェイスを受け取るポインタである。
vtbl 20 HRESULT get_AuthorizedApplications(INetFwAuthorizedApplications** apps)

プロファイルの承認済みアプリケーションのコレクションを取得します。

appsINetFwAuthorizedApplications**out許可済みアプリケーションのコレクションを表す INetFwAuthorizedApplications インターフェイスを受け取るポインタである。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数: 
#define global IID_INetFwProfile "{174A0DDA-E9F9-449D-993B-21AB667CA456}"
#usecom global INetFwProfile IID_INetFwProfile "{}"
#comfunc global INetFwProfile_get_Type                                          7 var
#comfunc global INetFwProfile_get_FirewallEnabled                               8 var
#comfunc global INetFwProfile_put_FirewallEnabled                               9 int
#comfunc global INetFwProfile_get_ExceptionsNotAllowed                          10 var
#comfunc global INetFwProfile_put_ExceptionsNotAllowed                          11 int
#comfunc global INetFwProfile_get_NotificationsDisabled                         12 var
#comfunc global INetFwProfile_put_NotificationsDisabled                         13 int
#comfunc global INetFwProfile_get_UnicastResponsesToMulticastBroadcastDisabled  14 var
#comfunc global INetFwProfile_put_UnicastResponsesToMulticastBroadcastDisabled  15 int
#comfunc global INetFwProfile_get_RemoteAdminSettings                           16 sptr
#comfunc global INetFwProfile_get_IcmpSettings                                  17 sptr
#comfunc global INetFwProfile_get_GloballyOpenPorts                             18 sptr
#comfunc global INetFwProfile_get_Services                                      19 sptr
#comfunc global INetFwProfile_get_AuthorizedApplications                        20 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。