IAzClientContext2::GetAssignedScopesPage 메서드(azroles.h)

GetAssignedScopesPage 메서드는 현재 IAzClientContext2 개체가 나타내는 클라이언트가 하나 이상의 역할에 할당된 범위 목록을 검색합니다.

구문

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

매개 변수

[in] lOptions

이 메서드가 scope 할당에 대해 LDAP 쿼리 그룹을 확인하는지 여부를 지정하는 플래그입니다. 이전에 캐시된 LDAP 쿼리 그룹은 이 플래그의 값에 관계없이 확인됩니다.

값	의미
AZ_CLIENT_CONTEXT_SKIP_LDAP_QUERY 1	이전에 캐시되지 않은 LDAP 쿼리 그룹은 확인되지 않습니다.

[in] PageSize

각 페이지 결과의 요소 수입니다.

[in, out] pvarCursor

결과의 현재 페이지를 나타내는 VARIANT 에 대한 포인터입니다. GetAssignedScopesPage 메서드에 대한 첫 번째 호출의 경우 VT_EMPTY 이 매개 변수의 값으로 전달하여 결과의 첫 번째 페이지를 검색합니다. 페이지의 요소 수는 PageSize 매개 변수의 값에 따라 결정됩니다. 출력에서 이 매개 변수에는 결과의 다음 페이지를 검색하기 위해 GetAssignedScopesPage 에 대한 다음 호출에서 전달할 값이 포함됩니다. 출력에서 이 매개 변수의 값이 EMPTY이면 결과 페이지가 더 이상 없습니다.

pvarScopeNames

반환 시 VARIANT 형식의 변수 배열을 포함합니다. 배열의 각 요소는 VT_BSTR 형식이며 현재 클라이언트가 할당된 scope 이름을 포함합니다. 배열의 요소 수는 PageSize 매개 변수로 지정됩니다.

반환 값

메서드가 성공하면 메서드는 S_OK 반환합니다.

메서드가 실패하면 오류를 나타내는 HRESULT 값이 반환됩니다. 일반적인 오류 코드 목록은 일반적인 HRESULT 값을 참조하세요.

설명

여러 스레드가 동일한 권한 부여 저장소에 액세스하는 경우 스레드 중 하나에서 GetAssignedScopesPage 메서드를 호출하면 다른 스레드가 저장소를 수정하는 경우 정확한 결과가 반환되지 않을 수 있습니다.

JScript에서 반환된 SAFEARRAY 값을 JScript Array 개체로 변환해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	지원되는 버전 없음
지원되는 최소 서버	Windows Server 2008, Windows Server 2003 SP1 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	azroles.h
라이브러리	Azroles.lib
DLL	Azroles.dll
재배포 가능 파일	Windows XP의 Windows Server 2003 관리 도구 팩