IAzApplication::InitializeClientContextFromName 메서드(azroles.h)

  • 아티클

InitializeClientContextFromName 메서드는 클라이언트 ID에서 IAzClientContext 개체 포인터를 (도메인 이름, 클라이언트 이름) 쌍으로 가져옵니다.

참고 가능하면 InitializeClientContextFromName 대신 InitializeClientContextFromToken 함수를 호출합니다. 자세한 내용은 설명 부분을 참조하세요.

 

구문

HRESULT InitializeClientContextFromName(
  [in]           BSTR             ClientName,
  [in, optional] BSTR             DomainName,
  [in, optional] VARIANT          varReserved,
  [out]          IAzClientContext **ppClientContext
);

매개 변수

[in] ClientName

보안 주체의 이름입니다.

[in, optional] DomainName

사용자 계정이 있는 도메인 이름입니다. 기본값은 NULL입니다.

[in, optional] varReserved

다음에 사용하도록 예약됩니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

  • varReserved.vt == VT_ERROR 및 varReserved.scode == DISP_E_PARAMNOTFOUND
  • varReserved.vt == VT_EMPTY
  • varReserved.vt == VT_NULL
  • varReserved.vt == VT_I4 및 varReserved.lVal == 0
  • varReserved.vt == VT_I2 및 varReserved.iVal == 0

[out] ppClientContext

반환된 IAzClientContext 개체에 대한 포인터에 대한 포인터입니다.

반환 값

함수가 성공하면 함수는 S_OK 반환합니다.

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

설명

가능하면 InitializeClientContextFromName 대신 InitializeClientContextFromToken 함수를 호출합니다. InitializeClientContextFromName 은 클라이언트가 실제로 로그온한 로그온 토큰에서 사용할 수 있는 정보를 검색하려고 시도합니다. 실제 로그온 토큰은 로그온 유형 및 로그온 속성과 같은 자세한 정보를 제공하며 로그온에 사용되는 인증 패키지의 동작을 반영합니다. InitializeClientContextFromToken에서 만든 클라이언트 컨텍스트는 로그온 토큰을 사용하며, 결과 클라이언트 컨텍스트는 InitializeClientContextFromName에서 만든 클라이언트 컨텍스트보다 더 완전하고 정확합니다.

SidTypeUser를 나타내려면 DomainName 및 ClientName 매개 변수를 결합해야 합니다.

지원되는 이름 형식은 LookupAccountName 함수에서 지원하는 형식과 동일합니다.

중요 애플리케이션은 호출 컨텍스트에 이 함수를 사용할 수 있는 권한이 있다고 가정해서는 안 됩니다. AuthzInitializeContextFromSid 함수는 호출에 지정된 SID의 tokenGroupsGlobalAndUniversal 특성을 읽어 현재 사용자의 그룹 멤버 자격을 확인합니다. 사용자의 개체가 Active Directory에 있는 경우 호출 컨텍스트는 사용자 개체의 tokenGroupsGlobalAndUniversal 특성에 대한 읽기 권한이 있어야 합니다. tokenGroupsGlobalAndUniversal 특성에 대한 읽기 권한은 사전 Windows 2000 호환 액세스 그룹에 부여되지만 기본 설정 선택은 Windows 2000 및 Windows Server 2003과 호환되는 사용 권한이므로 새 도메인에는 기본적으로 빈 Pre-Windows 2000 호환 액세스 그룹이 포함됩니다. 따라서 애플리케이션은 tokenGroupsGlobalAndUniversal 특성에 액세스할 수 없을 수 있습니다. 이 경우 AuthzInitializeContextFromSid 함수는 ACCESS_DENIED 실패합니다. 이 함수를 사용하는 애플리케이션은 이 오류를 올바르게 처리하고 지원 설명서를 제공해야 합니다. 사용자의 그룹 정보를 쿼리할 수 있는 권한 부여를 간소화하려면 그룹 정보를 조회하는 기능이 필요한 계정을 Windows 권한 부여 액세스 그룹에 추가합니다.
 
이 함수를 호출하는 애플리케이션은 정규화된 도메인 이름 또는 UPN( 사용자 계정 이름)을 사용해야 합니다. 그렇지 않으면 NetBIOS 도메인 이름이 사용되고 두 도메인에 직접 트러스트 관계가 없는 경우 이 메서드가 포리스트 간에 실패할 수 있습니다.

요구 사항

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

추가 정보

익명 액세스 허용

IAzApplication