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

IAzScope

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

公式ドキュメント

アプリケーションがアクセスを管理するリソースの論理的なコンテナーを定義します。

メソッド 38

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

vtbl 7 HRESULT get_Name(LPWSTR* pbstrName)

スコープの名前を設定または取得します。(Get)

pbstrNameLPWSTR*outスコープの名前を受け取る文字列へのポインタである。

解説(Remarks)

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

vtbl 8 HRESULT put_Name(LPWSTR bstrName)

スコープの名前を設定または取得します。(Put)

bstrNameLPWSTRinスコープに設定する名前を指定する。

解説(Remarks)

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

vtbl 9 HRESULT get_Description(LPWSTR* pbstrDescription)

スコープを説明するコメントを設定または取得します。(Get)

pbstrDescriptionLPWSTR*outスコープの説明文を受け取る文字列へのポインタである。

解説(Remarks)

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

vtbl 10 HRESULT put_Description(LPWSTR bstrDescription)

スコープを説明するコメントを設定または取得します。(Put)

bstrDescriptionLPWSTRinスコープに設定する説明文を指定する。

解説(Remarks)

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

vtbl 11 HRESULT get_ApplicationData(LPWSTR* pbstrApplicationData)

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

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

解説(Remarks)

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

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

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

解説(Remarks)

重要 ポリシー管理者はこのプロパティの読み取りと書き込みを行えます。ポリシー管理者に公開すべきでないデータを ApplicationData プロパティに格納しないでください。
vtbl 13 HRESULT get_Writable(BOOL* pfProp)

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

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

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

lPropIdINTin

返す IAzScope オブジェクトプロパティのプロパティ ID。指定可能な値を次の表に示します。

値 意味
AZ_PROP_APPLICATION_DATA
 ApplicationData プロパティからもアクセスできます
AZ_PROP_CHILD_CREATE
 現在のユーザーが子オブジェクトを作成する権限を持つかどうかを判定します。権限がある場合は TRUE、それ以外の場合は FALSE です。
AZ_PROP_DESCRIPTION
 Description プロパティからもアクセスできます
AZ_PROP_NAME
 Name プロパティからもアクセスできます
AZ_PROP_POLICY_ADMINS
 PolicyAdministrators プロパティからもアクセスできます
AZ_PROP_POLICY_ADMINS_NAME
 PolicyAdministratorsName プロパティからもアクセスできます
AZ_PROP_POLICY_READERS
 PolicyReaders プロパティからもアクセスできます
AZ_PROP_POLICY_READERS_NAME
 PolicyReadersName プロパティからもアクセスできます
AZ_PROP_SCOPE_BIZRULES_WRITABLE
 BizrulesWritable プロパティからもアクセスできます
AZ_PROP_SCOPE_CAN_BE_DELEGATED
 CanBeDelegated プロパティからもアクセスできます
AZ_PROP_WRITABLE
 Writable プロパティからもアクセスできます
varReservedVARIANTin将来の使用のために予約されています。
pvarPropVARIANT*out返される IAzScope オブジェクトプロパティへのポインター。

戻り値

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

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

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

lPropIdINTin

設定する IAzScope オブジェクトプロパティのプロパティ ID。指定可能な値を次の表に示します。

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

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

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

戻り値

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

解説(Remarks)

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

vtbl 16 HRESULT AddPropertyItem(INT lPropId, VARIANT varProp, VARIANT varReserved)

指定されたプリンシパルを、指定されたプリンシパルの一覧に追加します。(IAzScope.AddPropertyItem)

lPropIdINTin

varProp パラメーターで指定したプリンシパルを追加する先のプリンシパル一覧のプロパティ ID。指定可能な値を次の表に示します。

値 意味
AZ_PROP_POLICY_ADMINS
 AddPolicyAdministrator メソッドを使用して追加することもできます
AZ_PROP_POLICY_ADMINS_NAME
 AddPolicyAdministratorName メソッドを使用して追加することもできます
AZ_PROP_POLICY_READERS
 AddPolicyReader メソッドを使用して追加することもできます
AZ_PROP_POLICY_READERS_NAME
 AddPolicyReaderName メソッドを使用して追加することもできます
varPropVARIANTin

lPropId パラメーターで指定したプリンシパル一覧に追加するプリンシパル。

この variant は BSTR の variant でなければなりません。

lPropId パラメーターに AZ_PROP_POLICY_ADMINS または AZ_PROP_POLICY_READERS を指定した場合、文字列は一覧に追加する Windows アカウントのセキュリティ識別子 (SID) のテキスト形式です。lPropId パラメーターに AZ_PROP_POLICY_ADMINS_NAME または AZ_PROP_POLICY_READERS_NAME を指定した場合、文字列は一覧に追加するアカウントのアカウント名です。アカウント名は、ユーザープリンシパル名 (UPN) 形式 (例: "someone@example.com") または "ExampleDomain\UserName" 形式のいずれかで指定できます。

varReservedVARIANTin将来の使用のために予約されています。

戻り値

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

解説(Remarks)

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

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

指定されたプリンシパルを、指定されたプリンシパルの一覧から削除します。(IAzScope.DeletePropertyItem)

lPropIdINTin

varProp パラメーターで指定したプリンシパルを削除する対象のプリンシパル一覧のプロパティ ID。指定可能な値を次の表に示します。

値 意味
AZ_PROP_POLICY_ADMINS
 DeletePolicyAdministrator メソッドを使用して削除することもできます
AZ_PROP_POLICY_ADMINS_NAME
 DeletePolicyAdministratorName メソッドを使用して削除することもできます
AZ_PROP_POLICY_READERS
 DeletePolicyReader メソッドを使用して削除することもできます
AZ_PROP_POLICY_READERS_NAME
 DeletePolicyReaderName メソッドを使用して削除することもできます
varPropVARIANTin

lPropId パラメーターで指定したプリンシパル一覧から削除するプリンシパル。

この variant は BSTR の variant でなければなりません。

lPropId パラメーターに AZ_PROP_POLICY_ADMINS または AZ_PROP_POLICY_READERS を指定した場合、文字列は一覧から削除する Windows アカウントのセキュリティ識別子 (SID) のテキスト形式です。lPropId パラメーターに AZ_PROP_POLICY_ADMINS_NAME または AZ_PROP_POLICY_READERS_NAME を指定した場合、文字列は一覧から削除するアカウントのアカウント名です。アカウント名は、ユーザープリンシパル名 (UPN) 形式 (例: "someone@example.com") または "ExampleDomain\UserName" 形式のいずれかで指定できます。

varReservedVARIANTin将来の使用のために予約されています。

戻り値

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

vtbl 18 HRESULT get_PolicyAdministrators(VARIANT* pvarAdmins)

IAzScope の PolicyAdministrators プロパティは、ポリシー管理者として機能するプリンシパルのセキュリティ識別子 (SID) をテキスト形式で取得します。

pvarAdminsVARIANT*outポリシー管理者の SID の配列を格納した VARIANT を受け取るポインタである。

解説(Remarks)

オブジェクトのポリシー管理者は、次のタスクを実行できます。

JScript では、返される SAFEARRAY を JScript の Array オブジェクトに変換する必要があります。
vtbl 19 HRESULT get_PolicyReaders(VARIANT* pvarReaders)

IAzScope の PolicyReaders プロパティは、ポリシーリーダーとして機能するプリンシパルのセキュリティ識別子 (SID) をテキスト形式で取得します。

pvarReadersVARIANT*outポリシー読み取り者の SID の配列を格納した VARIANT を受け取るポインタである。

解説(Remarks)

オブジェクトのポリシーリーダーは、そのオブジェクトおよびその子オブジェクトの属性を読み取ることができます。またリーダーはポリシーを使用することもできます。たとえば、AccessCheck メソッドを呼び出せます。リーダーは、オブジェクトやその子オブジェクトを変更することはできません。

JScript では、返される SAFEARRAY を JScript の Array オブジェクトに変換する必要があります。

vtbl 20 HRESULT AddPolicyAdministrator(LPWSTR bstrAdmin, VARIANT varReserved)

IAzScope の AddPolicyAdministrator メソッドは、指定されたテキスト形式のセキュリティ識別子を、ポリシー管理者として機能するプリンシパルの一覧に追加します。

bstrAdminLPWSTRinポリシー管理者の一覧に追加する SID のテキスト形式。
varReservedVARIANTin将来の使用のために予約されています。

戻り値

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

解説(Remarks)

オブジェクトのポリシー管理者は、次のタスクを実行できます。

ポリシー管理者の一覧を表示するには、PolicyAdministrators プロパティを使用します。

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

vtbl 21 HRESULT DeletePolicyAdministrator(LPWSTR bstrAdmin, VARIANT varReserved)

IAzScope の DeletePolicyAdministrator メソッドは、指定されたテキスト形式のセキュリティ識別子を、ポリシー管理者として機能するプリンシパルの一覧から削除します。

bstrAdminLPWSTRinポリシー管理者の一覧から削除する SID のテキスト形式。
varReservedVARIANTin将来の使用のために予約されています。

戻り値

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

解説(Remarks)

オブジェクトのポリシー管理者は、次のタスクを実行できます。

ポリシー管理者の一覧を表示するには、PolicyAdministrators プロパティを使用します。

vtbl 22 HRESULT AddPolicyReader(LPWSTR bstrReader, VARIANT varReserved)

IAzScope の AddPolicyReader メソッドは、指定されたテキスト形式のセキュリティ識別子を、ポリシーリーダーとして機能するプリンシパルの一覧に追加します。

bstrReaderLPWSTRinポリシーリーダーの一覧に追加する SID のテキスト形式。
varReservedVARIANTin将来の使用のために予約されています。

戻り値

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

解説(Remarks)

オブジェクトのポリシーリーダーは、そのオブジェクトおよびその子オブジェクトの属性を読み取ることができます。またリーダーはポリシーを使用することもできます。たとえば、AccessCheck メソッドを呼び出せます。リーダーは、オブジェクトやその子オブジェクトを変更することはできません。

ポリシーリーダーの一覧を表示するには、PolicyReaders プロパティを使用します。

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

vtbl 23 HRESULT DeletePolicyReader(LPWSTR bstrReader, VARIANT varReserved)

IAzScope の DeletePolicyReader メソッドは、指定されたテキスト形式のセキュリティ識別子を、ポリシーリーダーとして機能するプリンシパルの一覧から削除します。

bstrReaderLPWSTRinポリシーリーダーの一覧から削除する SID のテキスト形式。
varReservedVARIANTin将来の使用のために予約されています。

戻り値

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

解説(Remarks)

オブジェクトのポリシーリーダーは、そのオブジェクトおよびその子オブジェクトの属性を読み取ることができます。またリーダーはポリシーを使用することもできます。たとえば、AccessCheck メソッドを呼び出せます。リーダーは、オブジェクトやその子オブジェクトを変更することはできません。

ポリシーリーダーの一覧を表示するには、PolicyReaders プロパティを使用します。

vtbl 24 HRESULT get_ApplicationGroups(IAzApplicationGroups** ppGroupCollection)

ポリシーデータから IAzApplicationGroup オブジェクトを列挙するために使用する IAzApplicationGroups オブジェクトを取得します。(IAzScope.get_ApplicationGroups)

ppGroupCollectionIAzApplicationGroups**outスコープ内のアプリケーショングループのコレクションを表す IAzApplicationGroups インターフェイスを受け取るポインタである。

解説(Remarks)

このプロパティは、IAzScope オブジェクトの直接の子オブジェクトである IAzApplicationGroup オブジェクトの列挙にのみ使用できます。

vtbl 25 HRESULT OpenApplicationGroup(LPWSTR bstrGroupName, VARIANT varReserved, IAzApplicationGroup** ppGroup)

名前を指定して IAzApplicationGroup オブジェクトを開きます。(IAzScope.OpenApplicationGroup)

bstrGroupNameLPWSTRin開く IAzApplicationGroup オブジェクトの名前。
varReservedVARIANTin将来の使用のために予約されています。
ppGroupIAzApplicationGroup**out開かれた IAzApplicationGroup オブジェクトへのポインターへのポインター。

戻り値

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

vtbl 26 HRESULT CreateApplicationGroup(LPWSTR bstrGroupName, VARIANT varReserved, IAzApplicationGroup** ppGroup)

指定された名前で IAzApplicationGroup オブジェクトを作成します。(IAzScope.CreateApplicationGroup)

bstrGroupNameLPWSTRin新しい IAzApplicationGroup オブジェクトの名前。
varReservedVARIANTin将来の使用のために予約されています。
ppGroupIAzApplicationGroup**out作成された IAzApplicationGroup オブジェクトへのポインターへのポインター。

戻り値

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

解説(Remarks)

返されたオブジェクトに加えた変更を永続化するには、IAzApplicationGroup::Submit メソッドを呼び出す必要があります。

返される IAzApplicationGroup オブジェクトは、IAzScope オブジェクトの直下の子オブジェクトです。

vtbl 27 HRESULT DeleteApplicationGroup(LPWSTR bstrGroupName, VARIANT varReserved)

指定された名前の IAzApplicationGroup オブジェクトを IAzScope オブジェクトから削除します。

bstrGroupNameLPWSTRin削除する IAzApplicationGroup オブジェクトの名前。
varReservedVARIANTin将来の使用のために予約されています。

戻り値

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

解説(Remarks)

キャッシュから削除された IAzApplicationGroup オブジェクトに対する IAzApplicationGroup の参照が残っていても、その IAzApplicationGroup オブジェクトは使用できなくなります。C++ では、削除された IAzApplicationGroup オブジェクトへの参照を IUnknown::Release メソッドを呼び出して解放する必要があります。C# および Visual Basic では、削除されたオブジェクトへの参照は自動的に解放されます。

vtbl 28 HRESULT get_Roles(IAzRoles** ppRoleCollection)

ポリシーデータから IAzRole オブジェクトを列挙するために使用する IAzRoles オブジェクトを取得します。

ppRoleCollectionIAzRoles**outスコープ内のロールのコレクションを表す IAzRoles インターフェイスを受け取るポインタである。

解説(Remarks)

このプロパティは、IAzScope オブジェクトの直接の子オブジェクトである IAzRole オブジェクトの列挙にのみ使用できます。

vtbl 29 HRESULT OpenRole(LPWSTR bstrRoleName, VARIANT varReserved, IAzRole** ppRole)

指定された名前の IAzRole オブジェクトを開きます。(IAzScope.OpenRole)

bstrRoleNameLPWSTRin開く IAzRole オブジェクトの名前。
varReservedVARIANTin将来の使用のために予約されています。
ppRoleIAzRole**out開かれた IAzRole オブジェクトへのポインターへのポインター。

戻り値

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

vtbl 30 HRESULT CreateRole(LPWSTR bstrRoleName, VARIANT varReserved, IAzRole** ppRole)

指定された名前で IAzRole オブジェクトを作成します。(IAzScope.CreateRole)

bstrRoleNameLPWSTRin新しい IAzRole オブジェクトの名前。
varReservedVARIANTin将来の使用のために予約されています。
ppRoleIAzRole**out作成された IAzRole オブジェクトへのポインターへのポインター。

戻り値

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

解説(Remarks)

返されたオブジェクトに加えた変更を永続化するには、IAzRole::Submit メソッドを呼び出す必要があります。

返される IAzRole オブジェクトは、IAzScope オブジェクトの直下の子オブジェクトです。

vtbl 31 HRESULT DeleteRole(LPWSTR bstrRoleName, VARIANT varReserved)

指定された名前の IAzRole オブジェクトを IAzScope オブジェクトから削除します。

bstrRoleNameLPWSTRin削除する IAzRole オブジェクトの名前。
varReservedVARIANTin将来の使用のために予約されています。

戻り値

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

解説(Remarks)

キャッシュから削除された IAzRole オブジェクトに対する IAzRole の参照が残っていても、その IAzRole オブジェクトは使用できなくなります。C++ では、削除された IAzRole オブジェクトへの参照を IUnknown::Release メソッドを呼び出して解放する必要があります。C# および Visual Basic では、削除されたオブジェクトへの参照は自動的に解放されます。

vtbl 32 HRESULT get_Tasks(IAzTasks** ppTaskCollection)

ポリシーデータから IAzTask オブジェクトを列挙するために使用する IAzTasks オブジェクトを取得します。

ppTaskCollectionIAzTasks**outスコープ内のタスクのコレクションを表す IAzTasks インターフェイスを受け取るポインタである。

解説(Remarks)

このプロパティは、IAzScope オブジェクトの直接の子オブジェクトである IAzTask オブジェクトの列挙にのみ使用できます。

vtbl 33 HRESULT OpenTask(LPWSTR bstrTaskName, VARIANT varReserved, IAzTask** ppTask)

指定された名前の IAzTask オブジェクトを開きます。(IAzScope.OpenTask)

bstrTaskNameLPWSTRin開く IAzTask オブジェクトの名前。
varReservedVARIANTin将来の使用のために予約されています。
ppTaskIAzTask**out開かれた IAzTask オブジェクトへのポインターへのポインター。

戻り値

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

vtbl 34 HRESULT CreateTask(LPWSTR bstrTaskName, VARIANT varReserved, IAzTask** ppTask)

指定された名前で IAzTask オブジェクトを作成します。(IAzScope.CreateTask)

bstrTaskNameLPWSTRin新しい IAzTask オブジェクトの名前。
varReservedVARIANTin将来の使用のために予約されています。
ppTaskIAzTask**out作成された IAzTask オブジェクトへのポインターへのポインター。

戻り値

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

解説(Remarks)

返されたオブジェクトに加えた変更を永続化するには、IAzTask::Submit メソッドを呼び出す必要があります。

返される IAzTask オブジェクトは、IAzScope オブジェクトの直下の子オブジェクトです。

vtbl 35 HRESULT DeleteTask(LPWSTR bstrTaskName, VARIANT varReserved)

指定された名前の IAzTask オブジェクトを IAzScope オブジェクトから削除します。

bstrTaskNameLPWSTRin削除する IAzTask オブジェクトの名前。
varReservedVARIANTin将来の使用のために予約されています。

戻り値

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

解説(Remarks)

キャッシュから削除された IAzTask オブジェクトに対する IAzTask の参照が残っていても、その IAzTask オブジェクトは使用できなくなります。C++ では、削除された IAzTask オブジェクトへの参照を IUnknown::Release メソッドを呼び出して解放する必要があります。C# および Visual Basic では、削除されたオブジェクトへの参照は自動的に解放されます。

vtbl 36 HRESULT Submit(INT lFlags, VARIANT varReserved)

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

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

戻り値

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

解説(Remarks)

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

Submit メソッドは子オブジェクトには及びません。子オブジェクトは個別にポリシーストアへ永続化する必要があります。作成した IAzScope オブジェクトは、参照したり親オブジェクトにしたりする前に Submit する必要があります。オブジェクトのデストラクターは、Submit されていない変更を通知なく破棄します。

vtbl 37 HRESULT get_CanBeDelegated(BOOL* pfProp)

スコープを委任できるかどうかを示す値を取得します。

pfPropBOOL*outこのスコープを委任できるかどうかを示す BOOL 値を受け取るポインタである。
vtbl 38 HRESULT get_BizrulesWritable(BOOL* pfProp)

委任されていないスコープが書き込み可能かどうかを示す値を取得します。

pfPropBOOL*outこのスコープのビジネスルールが書き込み可能かどうかを示す BOOL 値を受け取るポインタである。
vtbl 39 HRESULT get_PolicyAdministratorsName(VARIANT* pvarAdmins)

ポリシー管理者として機能するプリンシパルのアカウント名を取得します。(IAzScope.get_PolicyAdministratorsName)

pvarAdminsVARIANT*outポリシー管理者のアカウント名の配列を格納した VARIANT を受け取るポインタである。

解説(Remarks)

オブジェクトのポリシー管理者は、次のタスクを実行できます。

JScript では、返される SAFEARRAY を JScript の Array オブジェクトに変換する必要があります。
vtbl 40 HRESULT get_PolicyReadersName(VARIANT* pvarReaders)

ポリシーリーダーとして機能するプリンシパルのアカウント名を取得します。(IAzScope.get_PolicyReadersName)

pvarReadersVARIANT*outポリシー読み取り者のアカウント名の配列を格納した VARIANT を受け取るポインタである。

解説(Remarks)

オブジェクトのポリシーリーダーは、そのオブジェクトおよびその子オブジェクトの属性を読み取ることができます。またリーダーはポリシーを使用することもできます。たとえば、AccessCheck メソッドを呼び出せます。リーダーは、オブジェクトやその子オブジェクトを変更することはできません。

JScript では、返される SAFEARRAY を JScript の Array オブジェクトに変換する必要があります。

vtbl 41 HRESULT AddPolicyAdministratorName(LPWSTR bstrAdmin, VARIANT varReserved)

IAzScope の AddPolicyAdministratorName メソッドは、指定されたアカウント名を、ポリシー管理者として機能するプリンシパルの一覧に追加します。

bstrAdminLPWSTRinポリシー管理者の一覧に追加するアカウント名。アカウント名は、ユーザープリンシパル名 (UPN) 形式 (例: someone@example.com) または ExampleDomain\UserName 形式のいずれかで指定できます。ドメインが ExampleDomain\UserName 形式で指定されていない場合は、LookupAccountName 関数が呼び出されてドメインが取得されます。
varReservedVARIANTin将来の使用のために予約されています。

戻り値

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

解説(Remarks)

オブジェクトのポリシー管理者は、次のタスクを実行できます。

アカウント名形式でポリシー管理者の一覧を表示するには、PolicyAdministratorsName プロパティを使用します。

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

vtbl 42 HRESULT DeletePolicyAdministratorName(LPWSTR bstrAdmin, VARIANT varReserved)

IAzScope の DeletePolicyAdministratorName メソッドは、指定されたアカウント名を、ポリシー管理者として機能するプリンシパルの一覧から削除します。

bstrAdminLPWSTRinポリシー管理者の一覧から削除するアカウント名。アカウント名は、ユーザープリンシパル名 (UPN) 形式 (例: someone@example.com) または ExampleDomain\UserName 形式のいずれかで指定できます。ドメインが ExampleDomain\UserName 形式で指定されていない場合は、LookupAccountName 関数が呼び出されてドメインが取得されます。
varReservedVARIANTin将来の使用のために予約されています。

戻り値

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

解説(Remarks)

オブジェクトのポリシー管理者は、次のタスクを実行できます。

アカウント名形式でポリシー管理者の一覧を表示するには、PolicyAdministratorsName プロパティを使用します。

vtbl 43 HRESULT AddPolicyReaderName(LPWSTR bstrReader, VARIANT varReserved)

IAzScope の AddPolicyReaderName メソッドは、指定されたアカウント名を、ポリシーリーダーとして機能するプリンシパルの一覧に追加します。

bstrReaderLPWSTRinポリシーリーダーの一覧に追加するアカウント名。アカウント名は、ユーザープリンシパル名 (UPN) 形式 (例: someone@example.com) または ExampleDomain\UserName 形式のいずれかで指定できます。ドメインが ExampleDomain\UserName 形式で指定されていない場合は、LookupAccountName 関数が呼び出されてドメインが取得されます。
varReservedVARIANTin将来の使用のために予約されています。

戻り値

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

解説(Remarks)

オブジェクトのポリシーリーダーは、そのオブジェクトおよびその子オブジェクトの属性を読み取ることができます。またリーダーはポリシーを使用することもできます。たとえば、AccessCheck メソッドを呼び出せます。リーダーは、オブジェクトやその子オブジェクトを変更することはできません。

アカウント名形式でポリシーリーダーの一覧を表示するには、PolicyReadersName プロパティを使用します。

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

vtbl 44 HRESULT DeletePolicyReaderName(LPWSTR bstrReader, VARIANT varReserved)

IAzScope の DeletePolicyReaderName メソッドは、指定されたアカウント名を、ポリシーリーダーとして機能するプリンシパルの一覧から削除します。

bstrReaderLPWSTRinポリシーリーダーの一覧から削除するアカウント名。アカウント名は、ユーザープリンシパル名 (UPN) 形式 (例: someone@example.com) または ExampleDomain\UserName 形式のいずれかで指定できます。ドメインが ExampleDomain\UserName 形式で指定されていない場合は、LookupAccountName 関数が呼び出されてドメインが取得されます。
varReservedVARIANTin将来の使用のために予約されています。

戻り値

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

解説(Remarks)

オブジェクトのポリシーリーダーは、そのオブジェクトおよびその子オブジェクトの属性を読み取ることができます。またリーダーはポリシーを使用することもできます。たとえば、AccessCheck メソッドを呼び出せます。リーダーは、オブジェクトやその子オブジェクトを変更することはできません。

アカウント名形式でポリシーリーダーの一覧を表示するには、PolicyReadersName プロパティを使用します。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IAzScope "{00E52487-E08D-4514-B62E-877D5645F5AB}"
#usecom global IAzScope IID_IAzScope "{}"
#comfunc global IAzScope_get_Name                       7 var
#comfunc global IAzScope_put_Name                       8 wstr
#comfunc global IAzScope_get_Description                9 var
#comfunc global IAzScope_put_Description                10 wstr
#comfunc global IAzScope_get_ApplicationData            11 var
#comfunc global IAzScope_put_ApplicationData            12 wstr
#comfunc global IAzScope_get_Writable                   13 var
#comfunc global IAzScope_GetProperty                    14 int,int,var
#comfunc global IAzScope_SetProperty                    15 int,int,int
#comfunc global IAzScope_AddPropertyItem                16 int,int,int
#comfunc global IAzScope_DeletePropertyItem             17 int,int,int
#comfunc global IAzScope_get_PolicyAdministrators       18 var
#comfunc global IAzScope_get_PolicyReaders              19 var
#comfunc global IAzScope_AddPolicyAdministrator         20 wstr,int
#comfunc global IAzScope_DeletePolicyAdministrator      21 wstr,int
#comfunc global IAzScope_AddPolicyReader                22 wstr,int
#comfunc global IAzScope_DeletePolicyReader             23 wstr,int
#comfunc global IAzScope_get_ApplicationGroups          24 sptr
#comfunc global IAzScope_OpenApplicationGroup           25 wstr,int,sptr
#comfunc global IAzScope_CreateApplicationGroup         26 wstr,int,sptr
#comfunc global IAzScope_DeleteApplicationGroup         27 wstr,int
#comfunc global IAzScope_get_Roles                      28 sptr
#comfunc global IAzScope_OpenRole                       29 wstr,int,sptr
#comfunc global IAzScope_CreateRole                     30 wstr,int,sptr
#comfunc global IAzScope_DeleteRole                     31 wstr,int
#comfunc global IAzScope_get_Tasks                      32 sptr
#comfunc global IAzScope_OpenTask                       33 wstr,int,sptr
#comfunc global IAzScope_CreateTask                     34 wstr,int,sptr
#comfunc global IAzScope_DeleteTask                     35 wstr,int
#comfunc global IAzScope_Submit                         36 int,int
#comfunc global IAzScope_get_CanBeDelegated             37 var
#comfunc global IAzScope_get_BizrulesWritable           38 var
#comfunc global IAzScope_get_PolicyAdministratorsName   39 var
#comfunc global IAzScope_get_PolicyReadersName          40 var
#comfunc global IAzScope_AddPolicyAdministratorName     41 wstr,int
#comfunc global IAzScope_DeletePolicyAdministratorName  42 wstr,int
#comfunc global IAzScope_AddPolicyReaderName            43 wstr,int
#comfunc global IAzScope_DeletePolicyReaderName         44 wstr,int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。