Metodo IAzClientContext::GetRoles (azroles.h)

Il metodo GetRoles restituisce i ruoli per il contesto client.

Sintassi

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

Parametri

[in, optional] bstrScopeName

Nome dell'oggetto IAzScope da cui sono applicabili i ruoli restituiti nel parametro pvarRoleNames . Se questa proprietà è NULL, vengono restituiti i ruoli dall'ambito dell'applicazione; in caso contrario, i ruoli dell'ambito specificato vengono restituiti anziché i ruoli dall'ambito dell'applicazione.

[out] pvarRoleNames

Puntatore a UN VALORE VARIANT usato per restituire un OGGETTO SAFEARRAY. Ogni elemento di SAFEARRAY è un tipo VARIANT di tipo BSTR che contiene il nome di un ruolo a cui appartiene il client nell'ambito specificato dal parametro bstrScopeName .

Valore restituito

Il valore restituito è un HRESULT. Un valore di S_OK indica l'esito positivo. Qualsiasi altro valore indica che l'operazione non è riuscita.

Commenti

In JScript l'oggetto SAFEARRAY restituito deve essere convertito nell'oggetto Array JScript.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	azroles.h
Libreria	Azroles.lib
DLL	Azroles.dll
Componente ridistribuibile	Windows Server 2003 Administration Tools Pack in Windows XP