Metodo IAzClientContext2::GetAssignedScopesPage (azroles.h)

Articolo
02/26/2024

Il metodo GetAssignedScopesPage recupera un elenco degli ambiti in cui il client rappresentato dall'oggetto IAzClientContext2 corrente viene assegnato a almeno un ruolo.

Sintassi

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

Parametri

[in] lOptions

Flag che specifica se questo metodo controlla i gruppi di query LDAP per l'assegnazione dell'ambito. I gruppi di query LDAP memorizzati nella cache in precedenza vengono controllati indipendentemente dal valore di questo flag.

Valore	Significato
AZ_CLIENT_CONTEXT_SKIP_LDAP_QUERY 1	I gruppi di query LDAP non memorizzati nella cache non vengono controllati.

[in] PageSize

Numero di elementi in ogni risultato della pagina.

[in, out] pvarCursor

Puntatore a un valore VARIANT che rappresenta la pagina corrente dei risultati. Per la prima chiamata al metodo GetAssignedScopesPage , passare VT_EMPTY come valore per questo parametro per recuperare la prima pagina dei risultati. Il numero di elementi in una pagina è determinato dal valore del parametro PageSize . Nell'output, questo parametro contiene il valore da passare nella chiamata successiva a GetAssignedScopesPage per recuperare la pagina successiva dei risultati. Se il valore di questo parametro nell'output è VUOTO, non sono presenti più pagine dei risultati.

pvarScopeNames

In caso di restituzione, contiene una matrice di variabili di tipo VARIANT. Ogni elemento della matrice è di tipo VT_BSTR e contiene il nome di un ambito a cui viene assegnato il client corrente. Il numero di elementi nella matrice viene specificato dal parametro PageSize .

Valore restituito

Se il metodo ha esito positivo, il metodo restituisce S_OK.

Se il metodo ha esito negativo, restituisce un valore HRESULT che indica l'errore. Per un elenco di codici di errore comuni, vedere Valori HRESULT comuni.

Commenti

Se più thread accedono allo stesso archivio autorizzazioni, una chiamata al metodo GetAssignedScopesPage in uno dei thread potrebbe non restituire risultati accurati se l'altro thread modifica l'archivio.

In JScript i valori SAFEARRAY restituiti devono essere convertiti nell'oggetto Array JScript.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2008, Windows Server 2003 con SP1 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	azroles.h
Libreria	Azroles.lib
DLL	Azroles.dll
Componente ridistribuibile	Windows Server 2003 Administration Tools Pack in Windows XP

Condividi tramite