IAzClientContext::GetRoles-Methode (azroles.h)

Die GetRoles-Methode gibt die Rollen für den Clientkontext zurück.

Syntax

HRESULT GetRoles(
  [in, optional] BSTR    bstrScopeName,
  [out]          VARIANT *pvarRoleNames
);

Parameter

[in, optional] bstrScopeName

Der Name des IAzScope-Objekts , von dem die im pvarRoleNames-Parameter zurückgegebenen Rollen gelten. Wenn diese Eigenschaft NULL ist, werden die Rollen aus dem Anwendungsbereich zurückgegeben. andernfalls werden die Rollen aus dem angegebenen Bereich anstelle der Rollen aus dem Anwendungsbereich zurückgegeben.

[out] pvarRoleNames

Ein Zeiger auf einen VARIANT-Wert , der verwendet wird, um ein SAFEARRAY zurückzugeben. Jedes Element des SAFEARRAY ist ein VARIANT-Element vom Typ BSTR , das den Namen einer Rolle enthält, zu der der Client in dem durch den bstrScopeName-Parameter angegebenen Bereich gehört.

Rückgabewert

Der Rückgabewert ist ein HRESULT. Ein Wert von S_OK gibt den Erfolg an. Jeder andere Wert gibt an, dass beim Vorgang ein Fehler aufgetreten ist.

Hinweise

In JScript muss das zurückgegebene SAFEARRAY in das JScript-Array-Objekt konvertiert werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	azroles.h
Bibliothek	Azroles.lib
DLL	Azroles.dll
Verteilbare Komponente	Windows Server 2003 Administration Tools Pack unter Windows XP