Método IAzClientContext::GetRoles (azroles.h)

El método GetRoles devuelve los roles para el contexto de cliente.

Sintaxis

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

Parámetros

[in, optional] bstrScopeName

Nombre del objeto IAzScope del que se aplican los roles devueltos en el parámetro pvarRoleNames . Si esta propiedad es NULL, se devuelven los roles del ámbito de la aplicación; De lo contrario, los roles del ámbito especificado se devuelven en lugar de los roles del ámbito de la aplicación.

[out] pvarRoleNames

Puntero a un valor VARIANT usado para devolver un SAFEARRAY. Cada elemento de SAFEARRAY es un VARIANT de tipo BSTR que contiene el nombre de un rol al que pertenece el cliente en el ámbito especificado por el parámetro bstrScopeName .

Valor devuelto

El valor devuelto es hrESULT. Un valor de S_OK indica que se ha realizado correctamente. Cualquier otro valor indica que se produjo un error en la operación.

Comentarios

En JScript, la safearray devuelta debe convertirse en el objeto Array de JScript.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	azroles.h
Library	Azroles.lib
Archivo DLL	Azroles.dll
Redistribuible	Paquete de herramientas de administración de Windows Server 2003 en Windows XP