Metodo IAzClientContext2::GetAssignedScopesPage (azroles.h)
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 |
---|---|
|
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 |