Método IAzClientContext3::GetGroups (azroles.h)

Artigo
02/23/2024

O método GetGroups retorna uma matriz dos grupos de aplicativos associados a esse contexto de cliente.

Sintaxe

HRESULT GetGroups(
  [in]  BSTR    bstrScopeName,
  [in]  ULONG   ulOptions,
  [out] VARIANT *pGroupArray
);

Parâmetros

[in] bstrScopeName

O nome do escopo no qual marcar para grupos de aplicativos. Esse parâmetro será ignorado se o valor do parâmetro ulOptions estiver definido como AZ_CLIENT_CONTEXT_GET_GROUPS_STORE_LEVEL_ONLY.

[in] ulOptions

Um conjunto de sinalizadores que modificam o comportamento desse método. Isso pode ser zero ou uma combinação de um ou mais dos valores a seguir.

Valor	Significado
AZ_CLIENT_CONTEXT_GET_GROUPS_STORE_LEVEL_ONLY 0x2	Esse método verifica apenas os grupos de aplicativos no nível do repositório.

[out] pGroupArray

Um ponteiro para uma matriz dos nomes dos grupos de aplicativos associados a esse contexto de cliente.

Essa é uma variante que contém um objeto SAFEARRAY ou JScript Array . Cada elemento da matriz contém um VT_BSTR que contém o nome de um grupo de aplicativos.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK.

Se o método falhar, ele retornará um código de erro. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	azroles.h

Confira também

IAzClientContext3

Compartilhar via