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 管理ツール パック