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

INetFwService

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

公式ドキュメント

INetFwService インターフェイスは、ファイアウォールを通過してリッスンすることを許可される可能性のあるサービスのプロパティへのアクセスを提供します。

解説(Remarks)

このインターフェイスのインスタンスは、INetFwServices コレクションを通じて取得します。

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

メソッド 12

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

vtbl 7 HRESULT get_Name(LPWSTR* name)

サービスのフレンドリ名を取得します。

nameLPWSTR*outこのサービスの名前を表す文字列(BSTR)を受け取るポインタへのポインタである。
vtbl 8 HRESULT get_Type(NET_FW_SERVICE_TYPE* type)

サービスの種類を取得します。

typeNET_FW_SERVICE_TYPE*outこのサービスの種類を示す NET_FW_SERVICE_TYPE 列挙値を受け取るポインタである。
vtbl 9 HRESULT get_Customized(VARIANT_BOOL* customized)

サービスに関連付けられたポートの少なくとも 1 つがカスタマイズされているかどうかを示します。

customizedVARIANT_BOOL*outこのサービスの設定が既定からカスタマイズされているかどうかを示すブール値(VARIANT_BOOL)を受け取るポインタである。

解説(Remarks)

サービスがカスタマイズされている場合、サービスのプロパティが返す値は、そのサービスに関連付けられたすべてのポートの構成を反映しているとは限りません。

vtbl 10 HRESULT get_IpVersion(NET_FW_IP_VERSION* ipVersion)

サービスが許可されるファイアウォールの IP バージョンを指定します。(Get)

ipVersionNET_FW_IP_VERSION*outこのサービスに適用される IP バージョンを示す NET_FW_IP_VERSION 列挙値を受け取るポインタである。

解説(Remarks)

NET_FW_IP_VERSION_ANY のみがサポートされます。

vtbl 11 HRESULT put_IpVersion(NET_FW_IP_VERSION ipVersion)

サービスが許可されるファイアウォールの IP バージョンを指定します。(Put)

ipVersionNET_FW_IP_VERSIONinこのサービスに適用する IP バージョンを示す NET_FW_IP_VERSION 列挙値を指定する。

解説(Remarks)

NET_FW_IP_VERSION_ANY のみがサポートされます。

vtbl 12 HRESULT get_Scope(NET_FW_SCOPE* scope)

ポートがリッスンできるネットワークのスコープを制御します。(INetFwService.get_Scope)

scopeNET_FW_SCOPE*outこのサービスへのアクセスが許可されるネットワークスコープを示す NET_FW_SCOPE 列挙値を受け取るポインタである。

解説(Remarks)

Scope プロパティを設定する場合、有効なのは NET_FW_SCOPE_ALL と NET_FW_SCOPE_LOCAL_SUBNET のみです。

新しいポートの既定値は NET_FW_SCOPE_ALL です。

カスタムのスコープを作成するには、RemoteAddresses プロパティを使用します。

vtbl 13 HRESULT put_Scope(NET_FW_SCOPE scope)

ポートがリッスンできるネットワークのスコープを制御します。(INetFwService.put_Scope)

scopeNET_FW_SCOPEinこのサービスへのアクセスを許可するネットワークスコープを示す NET_FW_SCOPE 列挙値を指定する。

解説(Remarks)

Scope プロパティを設定する場合、有効なのは NET_FW_SCOPE_ALL と NET_FW_SCOPE_LOCAL_SUBNET のみです。

新しいポートの既定値は NET_FW_SCOPE_ALL です。

カスタムのスコープを作成するには、RemoteAddresses プロパティを使用します。

vtbl 14 HRESULT get_RemoteAddresses(LPWSTR* remoteAddrs)

サービスのポートがトラフィックをリッスンできるリモートアドレスの集合を指定します。(Get)

remoteAddrsLPWSTR*outこのサービスへのアクセスを許可するリモートアドレスの一覧を表す文字列(BSTR)を受け取るポインタへのポインタである。

解説(Remarks)

サービスがカスタマイズされている場合、取得時にはすべてのサービスポートのリモートアドレスの和集合が返されます。

remoteAddrs パラメーターは、アプリケーションがトラフィックをリッスンできるリモートアドレスを指定する、1 つ以上のコンマ区切りのトークンで構成されます。既定値は "*" です。

有効なトークン:

定義済みのアドレス範囲を使用するには、Scope プロパティを使用します。
vtbl 15 HRESULT put_RemoteAddresses(LPWSTR remoteAddrs)

サービスのポートがトラフィックをリッスンできるリモートアドレスの集合を指定します。(Put)

remoteAddrsLPWSTRinこのサービスへのアクセスを許可するリモートアドレスの一覧を表す文字列(BSTR)を指定する。

解説(Remarks)

サービスがカスタマイズされている場合、取得時にはすべてのサービスポートのリモートアドレスの和集合が返されます。

remoteAddrs パラメーターは、アプリケーションがトラフィックをリッスンできるリモートアドレスを指定する、1 つ以上のコンマ区切りのトークンで構成されます。既定値は "*" です。

有効なトークン:

定義済みのアドレス範囲を使用するには、Scope プロパティを使用します。
vtbl 16 HRESULT get_Enabled(VARIANT_BOOL* enabled)

サービスに関連付けられたすべてのポートが有効かどうかを示します。(Get)

enabledVARIANT_BOOL*outこのサービスが有効かどうかを示すブール値(VARIANT_BOOL)を受け取るポインタである。
vtbl 17 HRESULT put_Enabled(VARIANT_BOOL enabled)

サービスに関連付けられたすべてのポートが有効かどうかを示します。(Put)

enabledVARIANT_BOOLinこのサービスを有効にするかどうかを示すブール値(VARIANT_BOOL)を指定する。
vtbl 18 HRESULT get_GloballyOpenPorts(INetFwOpenPorts** openPorts)

サービスに関連付けられた、グローバルに開いているポートのコレクションを取得します。

openPortsINetFwOpenPorts**outこのサービスでグローバルに開放されているポートのコレクションを表す INetFwOpenPorts インターフェイスを受け取るポインタへのポインタである。
出典・ライセンス: 上記「公式ドキュメント」の内容は 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_INetFwService "{79FD57C8-908E-4A36-9888-D5B3F0A444CF}"
#usecom global INetFwService IID_INetFwService "{}"
#comfunc global INetFwService_get_Name               7 var
#comfunc global INetFwService_get_Type               8 var
#comfunc global INetFwService_get_Customized         9 var
#comfunc global INetFwService_get_IpVersion          10 var
#comfunc global INetFwService_put_IpVersion          11 int
#comfunc global INetFwService_get_Scope              12 var
#comfunc global INetFwService_put_Scope              13 int
#comfunc global INetFwService_get_RemoteAddresses    14 var
#comfunc global INetFwService_put_RemoteAddresses    15 wstr
#comfunc global INetFwService_get_Enabled            16 var
#comfunc global INetFwService_put_Enabled            17 int
#comfunc global INetFwService_get_GloballyOpenPorts  18 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。