nf-azroles-iazclientcontext2-getassignedscopespage.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NF:azroles.IAzClientContext2.GetAssignedScopesPage	IAzClientContext2::GetAssignedScopesPage (azroles.h)	Retrieves a list of the scopes in which the client represented by the current IAzClientContext2 object is assigned to at least one role.	AZ_CLIENT_CONTEXT_SKIP_LDAP_QUERY GetAssignedScopesPage GetAssignedScopesPage method [Security] GetAssignedScopesPage method [Security] IAzClientContext2 interface IAzClientContext2 interface [Security] GetAssignedScopesPage method IAzClientContext2.GetAssignedScopesPage IAzClientContext2::GetAssignedScopesPage azroles/IAzClientContext2::GetAssignedScopesPage security.iazclientcontext2_getassignedscopespage	security\iazclientcontext2_getassignedscopespage.htm	security	496dd834-37d9-41f6-a552-39c558dd60b3	12/05/2018	AZ_CLIENT_CONTEXT_SKIP_LDAP_QUERY, GetAssignedScopesPage, GetAssignedScopesPage method [Security], GetAssignedScopesPage method [Security],IAzClientContext2 interface, IAzClientContext2 interface [Security],GetAssignedScopesPage method, IAzClientContext2.GetAssignedScopesPage, IAzClientContext2::GetAssignedScopesPage, azroles/IAzClientContext2::GetAssignedScopesPage, security.iazclientcontext2_getassignedscopespage	azroles.h		Windows	None supported	Windows Server 2008, Windows Server 2003 with SP1 [desktop apps only]										Azroles.lib	Azroles.dll		Windows		Windows Server 2003 Administration Tools Pack on Windows XP	19H1	IAzClientContext2::GetAssignedScopesPage azroles/IAzClientContext2::GetAssignedScopesPage	c++	APIRef kbSyntax	COM	Azroles.dll	IAzClientContext2.GetAssignedScopesPage

IAzClientContext2::GetAssignedScopesPage

-description

The GetAssignedScopesPage method retrieves a list of the scopes in which the client represented by the current IAzClientContext2 object is assigned to at least one role.

-parameters

-param lOptions [in]

A flag that specifies whether this method checks LDAP query groups for scope assignment. Previously cached LDAP query groups are checked regardless of the value of this flag.

Value	Meaning
AZ_CLIENT_CONTEXT_SKIP_LDAP_QUERY 1	LDAP query groups that were not previously cached are not checked.

-param PageSize [in]

The number of elements in each page result.

-param pvarCursor [in, out]

A pointer to a VARIANT that represents the current page of results. For the first call to the GetAssignedScopesPage method, pass VT_EMPTY as the value for this parameter to retrieve the first page of results. The number of elements on a page is determined by the value of the PageSize parameter. On output, this parameter contains the value to be passed in the next call to GetAssignedScopesPage to retrieve the next page of results. If the value of this parameter on output is EMPTY, there are no more result pages.

-param pvarScopeNames

On return, contains an array of variables of type VARIANT. Each element of the array is of type VT_BSTR and contains the name of a scope to which the current client is assigned. The number of elements in the array is specified by the PageSize parameter.

-returns

If the method succeeds, the method returns S_OK.

If the method fails, it returns an HRESULT value that indicates the error. For a list of common error codes, see Common HRESULT Values.

-remarks

If multiple threads access the same authorization store, a call to the GetAssignedScopesPage method on one of the threads might not return accurate results if the other thread modifies the store.

In JScript, the returned SAFEARRAY values must be converted to the JScript Array object.