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

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

구문

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 함수에서 지원하는 형식과 동일합니다.

요구 사항

추가 정보

익명 액세스 허용

IAzApplication