Win32 API 日本語リファレンス
ホーム › Security.Authorization › IAzOperation

IAzOperation

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

公式ドキュメント

アプリケーションがサポートする低レベルの操作を定義します。

メソッド 12

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

vtbl 7 HRESULT get_Name(LPWSTR* pbstrName)

操作の名前を設定または取得します。(Get)

pbstrNameLPWSTR*out操作の名前を受け取る文字列へのポインタである。

解説(Remarks)

Name プロパティの最大長は 64 文字です。

vtbl 8 HRESULT put_Name(LPWSTR bstrName)

操作の名前を設定または取得します。(Put)

bstrNameLPWSTRin操作に設定する名前を指定する。

解説(Remarks)

Name プロパティの最大長は 64 文字です。

vtbl 9 HRESULT get_Description(LPWSTR* pbstrDescription)

IAzOperation の Description プロパティは、操作を説明するコメントを設定または取得します。(Get)

pbstrDescriptionLPWSTR*out操作の説明文を受け取る文字列へのポインタである。

解説(Remarks)

Description プロパティの最大長は 1,024 文字です。

vtbl 10 HRESULT put_Description(LPWSTR bstrDescription)

IAzOperation の Description プロパティは、操作を説明するコメントを設定または取得します。(Put)

bstrDescriptionLPWSTRin操作に設定する説明文を指定する。

解説(Remarks)

Description プロパティの最大長は 1,024 文字です。

vtbl 11 HRESULT get_ApplicationData(LPWSTR* pbstrApplicationData)

IAzOperation の ApplicationData プロパティは、アプリケーションが情報を格納するために使用できる不透明なフィールドを設定または取得します。(Get)

pbstrApplicationDataLPWSTR*outアプリケーション固有のデータ文字列を受け取る文字列へのポインタである。

解説(Remarks)

重要 ポリシー管理者はこのプロパティを読み書きできます。ポリシー管理者に公開すべきでないデータを ApplicationData プロパティに格納しないでください。
vtbl 12 HRESULT put_ApplicationData(LPWSTR bstrApplicationData)

IAzOperation の ApplicationData プロパティは、アプリケーションが情報を格納するために使用できる不透明なフィールドを設定または取得します。(Put)

bstrApplicationDataLPWSTRinアプリケーション固有のデータ文字列を指定する。

解説(Remarks)

重要 ポリシー管理者はこのプロパティを読み書きできます。ポリシー管理者に公開すべきでないデータを ApplicationData プロパティに格納しないでください。
vtbl 13 HRESULT get_OperationID(INT* plProp)

アプリケーション内で操作を一意に識別する、アプリケーション固有の値を設定または取得します。(Get)

plPropINT*out操作を識別する数値の操作 ID を受け取る整数へのポインタである。
vtbl 14 HRESULT put_OperationID(INT lProp)

アプリケーション内で操作を一意に識別する、アプリケーション固有の値を設定または取得します。(Put)

lPropINTin操作を識別する数値の操作 ID を指定する。
vtbl 15 HRESULT get_Writable(BOOL* pfProp)

この操作を初期化したユーザーコンテキストによって、操作を変更できるかどうかを示す値を取得します。

pfPropBOOL*out操作が書き込み可能かどうかを示す BOOL 値を受け取るポインタである。
vtbl 16 HRESULT GetProperty(INT lPropId, VARIANT varReserved, VARIANT* pvarProp)

指定されたプロパティ ID を持つ IAzOperation オブジェクトのプロパティを返します。

lPropIdINTin

返す IAzOperation オブジェクトのプロパティのプロパティ ID。指定できる値を次の表に示します。

値 意味
AZ_PROP_APPLICATION_DATA
 ApplicationData プロパティからもアクセスできます。
AZ_PROP_CHILD_CREATE
 現在のユーザーが子オブジェクトを作成する権限を持つかどうかを判定します。このオブジェクトは子オブジェクトを持てないため、この値は常に FALSE になります。
AZ_PROP_DESCRIPTION
 Description プロパティからもアクセスできます。
AZ_PROP_NAME
 Name プロパティからもアクセスできます。
AZ_PROP_OPERATION_ID
 OperationID プロパティからもアクセスできます。
AZ_PROP_WRITABLE
 Writable プロパティからもアクセスできます。
varReservedVARIANTin将来使用するために予約されています。
pvarPropVARIANT*out返される IAzOperation オブジェクトのプロパティへのポインター。

戻り値

戻り値は HRESULT です。S_OK は成功を示します。それ以外の値は操作が失敗したことを示します。

vtbl 17 HRESULT SetProperty(INT lPropId, VARIANT varProp, VARIANT varReserved)

指定されたプロパティ ID を持つ IAzOperation オブジェクトのプロパティに、指定した値を設定します。

lPropIdINTin

設定する IAzOperation オブジェクトのプロパティのプロパティ ID。指定できる値を次の表に示します。

値 意味
AZ_PROP_APPLICATION_DATA
 ApplicationData プロパティからもアクセスできます。
AZ_PROP_DESCRIPTION
 Description プロパティからもアクセスできます。
AZ_PROP_NAME
 Name プロパティからもアクセスできます。
AZ_PROP_OPERATION_ID
 OperationID プロパティからもアクセスできます。
varPropVARIANTin

lPropId パラメーターで指定した IAzOperation オブジェクトのプロパティに設定する値。lPropId パラメーターの値に応じて使用しなければならないデータ型を次の表に示します。

lPropId の値 データ型 (C++/Visual Basic)
AZ_PROP_APPLICATION_DATA
 BSTR/String
AZ_PROP_DESCRIPTION
 BSTR/String
AZ_PROP_OPERATION_ID
 LONG/Long
AZ_PROP_NAME
 BSTR/String
varReservedVARIANTin将来使用するために予約されています。

戻り値

戻り値は HRESULT です。S_OK は成功を示します。それ以外の値は操作が失敗したことを示します。

解説(Remarks)

このメソッドによる変更を永続化するには、Submit メソッドを呼び出す必要があります。

vtbl 18 HRESULT Submit(INT lFlags, VARIANT varReserved)

IAzOperation オブジェクトに加えた変更を永続化します。

lFlagsINTinSubmit メソッドの動作を変更するフラグ。既定値は 0 です。AZ_SUBMIT_FLAG_ABORT フラグを指定した場合、オブジェクトへの変更は破棄され、オブジェクトは基になるポリシーストアの内容と一致するように更新されます。
varReservedVARIANTin将来使用するために予約されています。

戻り値

メソッドが成功した場合は S_OK を返します。それ以外の HRESULT 値は操作が失敗したことを示します。

解説(Remarks)

IAzOperation オブジェクトへの追加や変更は、Submit メソッドが呼び出されるまで永続化されません。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IAzOperation "{5E56B24F-EA01-4D61-BE44-C49B5E4EAF74}"
#usecom global IAzOperation IID_IAzOperation "{}"
#comfunc global IAzOperation_get_Name             7 var
#comfunc global IAzOperation_put_Name             8 wstr
#comfunc global IAzOperation_get_Description      9 var
#comfunc global IAzOperation_put_Description      10 wstr
#comfunc global IAzOperation_get_ApplicationData  11 var
#comfunc global IAzOperation_put_ApplicationData  12 wstr
#comfunc global IAzOperation_get_OperationID      13 var
#comfunc global IAzOperation_put_OperationID      14 int
#comfunc global IAzOperation_get_Writable         15 var
#comfunc global IAzOperation_GetProperty          16 int,int,var
#comfunc global IAzOperation_SetProperty          17 int,int,int
#comfunc global IAzOperation_Submit               18 int,int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。