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

INetFwRule3

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

公式ドキュメント

アプリケーションまたはサービスが INetFwRule2 のすべてのプロパティにアクセスできるようにし、アプリコンテナーの要件へのアクセスを提供します。

メソッド 12

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

vtbl 45 HRESULT get_LocalAppPackageId(LPWSTR* wszPackageId)

Windows ストアアプリかデスクトップアプリかを問わず、プロセスのパッケージ識別子またはアプリコンテナー識別子を指定します。(Get)

wszPackageIdLPWSTR*out規則が対象とするローカルアプリケーションのパッケージ SID 文字列を受け取る文字列へのポインタである。
vtbl 46 HRESULT put_LocalAppPackageId(LPWSTR wszPackageId)

Windows ストアアプリかデスクトップアプリかを問わず、プロセスのパッケージ識別子またはアプリコンテナー識別子を指定します。(Put)

wszPackageIdLPWSTRin規則の対象とするローカルアプリケーションのパッケージ SID 文字列を指定する。
vtbl 47 HRESULT get_LocalUserOwner(LPWSTR* wszUserOwner)

規則の所有者であるユーザーのユーザーセキュリティ識別子 (SID) を指定します。(Get)

wszUserOwnerLPWSTR*out規則を所有するローカルユーザーの SID 文字列を受け取る文字列へのポインタである。

解説(Remarks)

この規則が localUserConditions を指定していない場合、この規則に一致するすべてのトラフィックは、このユーザー宛てであるか、このユーザーから発信されたものである必要があります。

vtbl 48 HRESULT put_LocalUserOwner(LPWSTR wszUserOwner)

規則の所有者であるユーザーのユーザーセキュリティ識別子 (SID) を指定します。(Put)

wszUserOwnerLPWSTRin規則を所有するローカルユーザーの SID 文字列を指定する。

解説(Remarks)

この規則が localUserConditions を指定していない場合、この規則に一致するすべてのトラフィックは、このユーザー宛てであるか、このユーザーから発信されたものである必要があります。

vtbl 49 HRESULT get_LocalUserAuthorizedList(LPWSTR* wszUserAuthList)

アプリコンテナーに対して承認されたローカルユーザーの一覧を指定します。(Get)

wszUserAuthListLPWSTR*outローカルで許可されるユーザーまたはグループを表す SDDL 形式の文字列を受け取る文字列へのポインタである。
vtbl 50 HRESULT put_LocalUserAuthorizedList(LPWSTR wszUserAuthList)

アプリコンテナーに対して承認されたローカルユーザーの一覧を指定します。(Put)

wszUserAuthListLPWSTRinローカルで許可するユーザーまたはグループを表す SDDL 形式の文字列を指定する。
vtbl 51 HRESULT get_RemoteUserAuthorizedList(LPWSTR* wszUserAuthList)

アプリコンテナーへのアクセスを承認されたリモートユーザーの一覧を指定します。(Get)

wszUserAuthListLPWSTR*outリモートで許可されるユーザーまたはグループを表す SDDL 形式の文字列を受け取る文字列へのポインタである。
vtbl 52 HRESULT put_RemoteUserAuthorizedList(LPWSTR wszUserAuthList)

アプリコンテナーへのアクセスを承認されたリモートユーザーの一覧を指定します。(Put)

wszUserAuthListLPWSTRinリモートで許可するユーザーまたはグループを表す SDDL 形式の文字列を指定する。
vtbl 53 HRESULT get_RemoteMachineAuthorizedList(LPWSTR* wszUserAuthList)

アプリコンテナーへのアクセスを承認されたリモートコンピューターの一覧を指定します。(Get)

wszUserAuthListLPWSTR*outリモートで許可されるコンピューターを表す SDDL 形式の文字列を受け取る文字列へのポインタである。
vtbl 54 HRESULT put_RemoteMachineAuthorizedList(LPWSTR wszUserAuthList)

アプリコンテナーへのアクセスを承認されたリモートコンピューターの一覧を指定します。(Put)

wszUserAuthListLPWSTRinリモートで許可するコンピューターを表す SDDL 形式の文字列を指定する。
vtbl 55 HRESULT get_SecureFlags(INT* lOptions)

コレクションを許可するために保証されなければならない、IPsec によって提供されるセキュリティレベルのファイアウォール検証を指定します。指定できる値は NET_FW_AUTHENTICATE_TYPE 列挙型の値に対応している必要があります。(Get)

lOptionsINT*out規則に要求されるセキュリティ (認証や暗号化など) の条件を示す NET_FW_AUTHENTICATE_TYPE 値を受け取る整数へのポインタである。
vtbl 56 HRESULT put_SecureFlags(INT lOptions)

コレクションを許可するために保証されなければならない、IPsec によって提供されるセキュリティレベルのファイアウォール検証を指定します。指定できる値は NET_FW_AUTHENTICATE_TYPE 列挙型の値に対応している必要があります。(Put)

lOptionsINTin規則に要求するセキュリティ (認証や暗号化など) の条件を示す NET_FW_AUTHENTICATE_TYPE 値を指定する。
出典・ライセンス: 上記「公式ドキュメント」の内容は 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_INetFwRule3 "{B21563FF-D696-4222-AB46-4E89B73AB34A}"
#usecom global INetFwRule3 IID_INetFwRule3 "{2C5BC43E-3369-4C33-AB0C-BE9469677AF4}"
#comfunc global INetFwRule3_get_LocalAppPackageId            45 var
#comfunc global INetFwRule3_put_LocalAppPackageId            46 wstr
#comfunc global INetFwRule3_get_LocalUserOwner               47 var
#comfunc global INetFwRule3_put_LocalUserOwner               48 wstr
#comfunc global INetFwRule3_get_LocalUserAuthorizedList      49 var
#comfunc global INetFwRule3_put_LocalUserAuthorizedList      50 wstr
#comfunc global INetFwRule3_get_RemoteUserAuthorizedList     51 var
#comfunc global INetFwRule3_put_RemoteUserAuthorizedList     52 wstr
#comfunc global INetFwRule3_get_RemoteMachineAuthorizedList  53 var
#comfunc global INetFwRule3_put_RemoteMachineAuthorizedList  54 wstr
#comfunc global INetFwRule3_get_SecureFlags                  55 var
#comfunc global INetFwRule3_put_SecureFlags                  56 int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。