IAzClientContext3::GetGroups-Methode (azroles.h)

Artikel
02/23/2024

Die GetGroups-Methode gibt ein Array der Anwendungsgruppen zurück, die diesem Clientkontext zugeordnet sind.

Syntax

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

Parameter

[in] bstrScopeName

Der Name des Bereichs, in dem nach Anwendungsgruppen gesucht werden soll. Dieser Parameter wird ignoriert, wenn der Wert des ulOptions-Parameters auf AZ_CLIENT_CONTEXT_GET_GROUPS_STORE_LEVEL_ONLY festgelegt ist.

[in] ulOptions

Eine Reihe von Flags, die das Verhalten dieser Methode ändern. Dies kann null oder eine Kombination aus einem oder mehreren der folgenden Werte sein.

Wert	Bedeutung
AZ_CLIENT_CONTEXT_GET_GROUPS_STORE_LEVEL_ONLY 0x2	Diese Methode überprüft nur auf Anwendungsgruppen auf Speicherebene.

[out] pGroupArray

Ein Zeiger auf ein Array der Namen von Anwendungsgruppen, die diesem Clientkontext zugeordnet sind.

Dies ist eine Variante, die entweder ein SAFEARRAY - oder das JScript-Array-Objekt enthält. Jedes Element des Arrays enthält eine VT_BSTR , die den Namen einer Anwendungsgruppe enthält.

Rückgabewert

Wenn die Methode erfolgreich ist, gibt sie S_OK zurück.

Bei einem Fehler gibt diese Methode einen Fehlercode zurück. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	azroles.h

Weitere Informationen

IAzClientContext3

Freigeben über