Método IAzClientContext2::GetAssignedScopesPage (azroles.h)

O método GetAssignedScopesPage recupera uma lista dos escopos nos quais o cliente representado pelo objeto IAzClientContext2 atual é atribuído a pelo menos uma função.

Sintaxe

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

Parâmetros

[in] lOptions

Um sinalizador que especifica se esse método verifica grupos de consultas LDAP quanto à atribuição de escopo. Grupos de consultas LDAP armazenados em cache anteriormente são verificados independentemente do valor desse sinalizador.

Valor	Significado
AZ_CLIENT_CONTEXT_SKIP_LDAP_QUERY 1	Os grupos de consultas LDAP que não foram armazenados em cache anteriormente não são verificados.

[in] PageSize

O número de elementos em cada resultado de página.

[in, out] pvarCursor

Um ponteiro para um VARIANT que representa a página atual de resultados. Para a primeira chamada para o método GetAssignedScopesPage , passe VT_EMPTY como o valor desse parâmetro para recuperar a primeira página de resultados. O número de elementos em uma página é determinado pelo valor do parâmetro PageSize . Na saída, esse parâmetro contém o valor a ser passado na próxima chamada para GetAssignedScopesPage para recuperar a próxima página de resultados. Se o valor desse parâmetro na saída for EMPTY, não haverá mais páginas de resultados.

pvarScopeNames

No retorno, contém uma matriz de variáveis do tipo VARIANT. Cada elemento da matriz é do tipo VT_BSTR e contém o nome de um escopo ao qual o cliente atual é atribuído. O número de elementos na matriz é especificado pelo parâmetro PageSize .

Retornar valor

Se o método for bem-sucedido, o método retornará S_OK.

Se o método falhar, ele retornará um valor HRESULT que indica o erro. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

Comentários

Se vários threads acessarem o mesmo repositório de autorização, uma chamada para o método GetAssignedScopesPage em um dos threads poderá não retornar resultados precisos se o outro thread modificar o repositório.

No JScript, os valores SAFEARRAY retornados devem ser convertidos no objeto JScript Array .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Nenhum compatível
Servidor mínimo com suporte	Windows Server 2008, Windows Server 2003 com SP1 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	azroles.h
Biblioteca	Azroles.lib
DLL	Azroles.dll
Redistribuível	Pacote de Ferramentas de Administração do Windows Server 2003 no Windows XP