IAzClientContext::GetRoles メソッド (azroles.h)
GetRoles メソッドは、クライアント コンテキストのロールを返します。
構文
HRESULT GetRoles(
[in, optional] BSTR bstrScopeName,
[out] VARIANT *pvarRoleNames
);
パラメーター
[in, optional] bstrScopeName
pvarRoleNames パラメーターで返されるロールが適用できる IAzScope オブジェクトの名前。 このプロパティが NULL の場合は、アプリケーション スコープのロールが返されます。それ以外の場合は、アプリケーション スコープのロールではなく、指定したスコープのロールが返されます。
[out] pvarRoleNames
SAFEARRAY を返すために使用される VARIANT へのポインター。 SAFEARRAY の各要素は、bstrScopeName パラメーターで指定されたスコープでクライアントが属するロールの名前を含む、BSTR 型の VARIANT です。
戻り値
戻り値は HRESULT です。 S_OK の値は成功を示します。 その他の値は、操作が失敗したことを示します。
注釈
JScript では、返される SAFEARRAY を JScript Array オブジェクトに変換する必要があります。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
対象プラットフォーム | Windows |
ヘッダー | azroles.h |
Library | Azroles.lib |
[DLL] | Azroles.dll |
再頒布可能パッケージ | Windows XP の Windows Server 2003 管理ツール パック |