IAzClientContext2::GetAssignedScopesPage-Methode (azroles.h)

Die GetAssignedScopesPage-Methode ruft eine Liste der Bereiche ab, in denen der durch das aktuelle IAzClientContext2-Objekt dargestellte Client mindestens einer Rolle zugewiesen ist.

Syntax

HRESULT GetAssignedScopesPage(
  [in]      LONG    lOptions,
  [in]      LONG    PageSize,
  [in, out] VARIANT *pvarCursor,
            VARIANT *pvarScopeNames
);

Parameter

[in] lOptions

Ein Flag, das angibt, ob diese Methode LDAP-Abfragegruppen auf Bereichszuweisung überprüft. Zuvor zwischengespeicherte LDAP-Abfragegruppen werden unabhängig vom Wert dieses Flags überprüft.

Wert	Bedeutung
AZ_CLIENT_CONTEXT_SKIP_LDAP_QUERY 1	LDAP-Abfragegruppen, die zuvor nicht zwischengespeichert wurden, werden nicht überprüft.

[in] PageSize

Die Anzahl der Elemente auf jeder Seite.

[in, out] pvarCursor

Ein Zeiger auf einen VARIANT-Wert , der die aktuelle Ergebnisseite darstellt. Übergeben Sie für den ersten Aufruf der GetAssignedScopesPage-MethodeVT_EMPTY als Wert für diesen Parameter, um die erste Seite der Ergebnisse abzurufen. Die Anzahl der Elemente auf einer Seite wird durch den Wert des PageSize-Parameters bestimmt. Bei der Ausgabe enthält dieser Parameter den Wert, der beim nächsten Aufruf von GetAssignedScopesPage übergeben werden soll, um die nächste Ergebnisseite abzurufen. Wenn der Wert dieses Parameters für die Ausgabe LEER ist, gibt es keine Ergebnisseiten mehr.

pvarScopeNames

Enthält bei der Rückgabe ein Array von Variablen vom Typ VARIANT. Jedes Element des Arrays ist vom Typ VT_BSTR und enthält den Namen eines Bereichs, dem der aktuelle Client zugewiesen ist. Die Anzahl der Elemente im Array wird durch den PageSize-Parameter angegeben.

Rückgabewert

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

Wenn die Methode fehlschlägt, gibt sie einen HRESULT-Wert zurück, der den Fehler angibt. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

Hinweise

Wenn mehrere Threads auf denselben Autorisierungsspeicher zugreifen, gibt ein Aufruf der GetAssignedScopesPage-Methode für einen der Threads möglicherweise keine genauen Ergebnisse zurück, wenn der andere Thread den Speicher ändert.

In JScript müssen die zurückgegebenen SAFEARRAY-Werte in das JScript-Array-Objekt konvertiert werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2008, Windows Server 2003 mit SP1 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	azroles.h
Bibliothek	Azroles.lib
DLL	Azroles.dll
Verteilbare Komponente	Windows Server 2003 Administration Tools Pack unter Windows XP