ホーム › Security.Authorization › IAzBizRuleContext

IAzBizRuleContext

COMIDispatch (デュアル)

📘 Microsoft Learn (日本語) · English

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

IIDe192f17d-d59f-455e-a152-940316cd77b2継承元IDispatch呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl7

公式ドキュメント

ビジネスルール (BizRule) 操作に関する情報を保持します。

解説(Remarks)

IAzClientContext::AccessCheck メソッドは、BizRule スクリプトを呼び出す前に AzBizRuleContext オブジェクトを作成します。

メソッド 4

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

vtbl 7 HRESULT put_BusinessRuleResult(BOOL bResult)

ビジネスルール (BizRule) が要求されたタスクの実行をユーザーに許可するかどうかを示す値を設定します。

bResult

BOOL

ビジネスルールによるアクセス許可の判定結果をBOOLで指定する。TRUEで許可を表す。

vtbl 8 HRESULT put_BusinessRuleString(LPWSTR bstrBusinessRuleString)

ビジネスルール (BizRule) のアプリケーション固有の文字列を設定または取得します。(Put)

bstrBusinessRuleString

LPWSTR

ビジネスルールが呼び出し元に返す任意の文字列をBSTRで指定する。

解説(Remarks)

このプロパティは、IAzClientContext::AccessCheck メソッドを呼び出したアプリケーションに返されます。用途の一例として、BizRule がユーザーのアクセスを拒否した理由を説明するために使用できます。

このプロパティの最大長は 65,536 文字です。

vtbl 9 HRESULT get_BusinessRuleString(LPWSTR* pbstrBusinessRuleString)

ビジネスルール (BizRule) のアプリケーション固有の文字列を設定または取得します。(Get)

pbstrBusinessRuleString

LPWSTR*

out

ビジネスルールが設定した文字列を格納したBSTRを受け取るポインタである。

解説(Remarks)

このプロパティの最大長は 65,536 文字です。

vtbl 10 HRESULT GetParameter(LPWSTR bstrParameterName, VARIANT* pvarParameterValue)

IAzClientContext::AccessCheck メソッドの varParameterValues 引数から、指定した値を取得します。

bstrParameterName	LPWSTR	in	返される値の名前。この名前は、AccessCheck メソッドの varParameterNames 引数に渡された配列の要素のいずれかの名前と一致する必要があります。重要 VBScript の利用者は、この引数と varParameterNames 引数内の名前との比較が大文字と小文字を区別することに注意してください。
pvarParameterValue	VARIANT*	out	bstrParameterName 引数で指定された名前に対応する、AccessCheck メソッドの varParameterValues 引数の値。見つからない場合は NULL。

戻り値

メソッドが成功した場合は S_OK を返します。

その他の HRESULT 値は、操作が失敗したことを示します。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IAzBizRuleContext "{E192F17D-D59F-455E-A152-940316CD77B2}"
#usecom global IAzBizRuleContext IID_IAzBizRuleContext "{5C2DC96F-8D51-434B-B33C-379BCCAE77C3}"
#comfunc global IAzBizRuleContext_put_BusinessRuleResult  7 int
#comfunc global IAzBizRuleContext_put_BusinessRuleString  8 wstr
#comfunc global IAzBizRuleContext_get_BusinessRuleString  9 var
#comfunc global IAzBizRuleContext_GetParameter            10 wstr,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。#define global IID_IAzBizRuleContext "{E192F17D-D59F-455E-A152-940316CD77B2}"
#usecom global IAzBizRuleContext IID_IAzBizRuleContext "{5C2DC96F-8D51-434B-B33C-379BCCAE77C3}"
#comfunc global IAzBizRuleContext_put_BusinessRuleResult  7 int
#comfunc global IAzBizRuleContext_put_BusinessRuleString  8 wstr
#comfunc global IAzBizRuleContext_get_BusinessRuleString  9 sptr
#comfunc global IAzBizRuleContext_GetParameter            10 wstr,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。