ホーム › NetworkManagement.WindowsFirewall › INetFwPolicy

INetFwPolicy

COMIDispatch (デュアル)

📘 Microsoft Learn (日本語) · English

✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。

IIDd46d2478-9ac9-4008-9dc7-5563ce5536cc継承元IDispatch呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl7

公式ドキュメント

INetFwPolicy インターフェイスは、ファイアウォールポリシーへのアクセスを提供します。

解説(Remarks)

このインターフェイスのインスタンスは、INetFwMgr インターフェイスの LocalPolicy プロパティを通じて取得します。

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

このインターフェイスにアクセスするには、Windows ファイアウォール / インターネット接続共有サービスが実行されている必要があります。

メソッド 2

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

vtbl 7 HRESULT get_CurrentProfile(INetFwProfile** profile)

現在のファイアウォールプロファイルを取得します。

profile

INetFwProfile**

out

現在適用されているファイアウォールプロファイルを表す INetFwProfile インターフェイスを受け取るポインタである。

解説(Remarks)

SharedAccess サービスが実行されている必要があります。

特定のプロファイルオブジェクトを取得するには、INetFwPolicy::CurrentProfile ではなく INetFwPolicy::GetProfileByType を使用してください。

Windows 7 では、netsh のコンテキスト current は、netsh advfirewall および netsh firewall において現在アクティブなすべてのプロファイルに対応します。それ以前のバージョンの Windows では、current は最も制限の厳しいプロファイルに対応します。

vtbl 8 HRESULT GetProfileByType(NET_FW_PROFILE_TYPE profileType, INetFwProfile** profile)

要求された種類のプロファイルを取得します。

profileType

NET_FW_PROFILE_TYPE

NET_FW_PROFILE_TYPE によるプロファイルの種類。

profile

INetFwProfile**

out

取得された INetFwProfile 型のプロファイル。

戻り値

C++

戻り値	説明
E_ACCESSDENIED	アクセス許可の問題により、操作が中止されました。
E_INVALIDARG	無効なパラメーターのため、メソッドが失敗しました。
E_OUTOFMEMORY	必要なメモリを割り当てることができませんでした。
E_POINTER	無効なポインターのため、メソッドが失敗しました。

VB

メソッドが成功した場合、戻り値は S_OK です。

メソッドが失敗した場合、戻り値は次のいずれかのエラーコードになります。

戻り値	説明
E_ACCESSDENIED	アクセス許可の問題により、操作が中止されました。
E_INVALIDARG	無効なパラメーターのため、メソッドが失敗しました。
E_OUTOFMEMORY	必要なメモリを割り当てることができませんでした。
E_POINTER	無効なポインターのため、メソッドが失敗しました。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_INetFwPolicy "{D46D2478-9AC9-4008-9DC7-5563CE5536CC}"
#usecom global INetFwPolicy IID_INetFwPolicy "{}"
#comfunc global INetFwPolicy_get_CurrentProfile  7 sptr
#comfunc global INetFwPolicy_GetProfileByType    8 int,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。