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

O método GetRoles retorna as funções para o contexto do cliente.

Sintaxe

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

Parâmetros

[in, optional] bstrScopeName

Nome do objeto IAzScope do qual as funções retornadas no parâmetro pvarRoleNames são aplicáveis. Se essa propriedade for NULL, as funções do escopo do aplicativo serão retornadas; caso contrário, as funções do escopo especificado são retornadas em vez das funções do escopo do aplicativo.

[out] pvarRoleNames

Um ponteiro para um VARIANT usado para retornar um SAFEARRAY. Cada elemento de SAFEARRAY é uma VARIANT do tipo BSTR que contém o nome de uma função à qual o cliente pertence no escopo especificado pelo parâmetro bstrScopeName .

Retornar valor

O valor retornado é um HRESULT. Um valor de S_OK indica êxito. Qualquer outro valor indica que a operação falhou.

Comentários

No JScript, o SAFEARRAY retornado deve ser convertido no objeto JScript Array .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	azroles.h
Biblioteca	Azroles.lib
DLL	Azroles.dll
Redistribuível	Pacote de Ferramentas de Administração do Windows Server 2003 no Windows XP