Metodo IAzClientContext3::GetGroups (azroles.h)

  • Articolo

Il metodo GetGroups restituisce una matrice dei gruppi di applicazioni associati a questo contesto client.

Sintassi

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

Parametri

[in] bstrScopeName

Nome dell'ambito in cui verificare la presenza di gruppi di applicazioni. Questo parametro viene ignorato se il valore del parametro ulOptions è impostato su AZ_CLIENT_CONTEXT_GET_GROUPS_STORE_LEVEL_ONLY.

[in] ulOptions

Set di flag che modificano il comportamento di questo metodo. Può essere zero o una combinazione di uno o più dei valori seguenti.

Valore Significato
AZ_CLIENT_CONTEXT_GET_GROUPS_STORE_LEVEL_ONLY
0x2
 Questo metodo controlla solo i gruppi di applicazioni a livello di archivio.

[out] pGroupArray

Puntatore a una matrice dei nomi dei gruppi di applicazioni associati a questo contesto client.

Si tratta di una variante che contiene un oggetto SAFEARRAY o JScript Array . Ogni elemento della matrice contiene un VT_BSTR che contiene il nome di un gruppo di applicazioni.

Valore restituito

Se il metodo ha esito positivo, restituisce S_OK.

Se il metodo ha esito negativo, viene restituito un codice errore. Per un elenco dei codici di errore comuni, vedere Valori HRESULT comuni.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione azroles.h

Vedi anche

IAzClientContext3