다음을 통해 공유

IX509EnrollmentPolicyServer::Initialize 메서드(certenroll.h)

  • 아티클

Initialize 메서드는 IX509EnrollmentPolicyServer 개체를 초기화합니다.

구문

HRESULT Initialize(
  [in] BSTR                             bstrPolicyServerUrl,
  [in] BSTR                             bstrPolicyServerId,
  [in] X509EnrollmentAuthFlags          authFlags,
  [in] VARIANT_BOOL                     fIsUnTrusted,
  [in] X509CertificateEnrollmentContext context
);

매개 변수

[in] bstrPolicyServerUrl

인증서 등록 정책 서버의 URL을 포함하는 BSTR 변수입니다.

[in] bstrPolicyServerId

인증서 등록 정책 서버에 대한 고유 ID를 포함하는 BSTR 변수입니다. 이 값이 NULL이 아니면 CEP 응답에서 반환된 ID 문자열과 일치해야 합니다.

[in] authFlags

클라이언트 인증 유형을 지정하는 X509EnrollmentAuthFlags 열거형 값입니다. 다음 값 중 하나일 수 있습니다.

값 의미
X509AuthAnonymous
 익명 인증.
X509AuthKerberos
 Kerberos 인증입니다.
X509AuthUsername
 텍스트 사용자 이름 및 암호 인증을 지웁
참고 사용자 이름과 암호는 전송 전에 암호화되며 CEP 서버의 자격 증명 모음에 안전하게 저장됩니다.
 
X509AuthCertificate
 로컬 컴퓨터에 설치되고 서버에서 클라이언트의 ID를 확인하는 데 사용하는 클라이언트 인증 인증서입니다.

[in] fIsUnTrusted

신뢰할 수 없는 인증 기관 인증서를 허용할지 여부를 지정하는 부울 값입니다.

[in] context

인증서 등록을 위한 최종 엔터티의 특성을 지정하는 X509CertificateEnrollmentContext 열거형 값입니다. 다음 값 중 하나일 수 있습니다.

값 의미
ContextUser
 인증서는 최종 사용자를 위한 것입니다.
ContextMachine
 인증서는 컴퓨터용입니다.
ContextAdministratorForceMachine
 컴퓨터 대신 작동하는 관리자가 인증서를 요청합니다.

반환 값

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

함수가 실패하면 오류를 나타내는 HRESULT 값을 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다. 일반적인 오류 코드 목록은 일반적인 HRESULT 값을 참조하세요.

반환 코드 설명
E_INVALIDARG
 bstrPolicyServerUrl 매개 변수는 빈 문자열일 수 없으며 HTTPS URL을 나타내야 합니다.
E_OUTOFMEMORY
 bstrPolicyServerUrl 또는 bstrPolicyServerId 매개 변수에 지정된 문자열에 사용할 수 있는 메모리가 부족했습니다.
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
 IX509EnrollmentPolicyServer 개체가 이미 초기화되었습니다.
HRESULT_FROM_WIN32(ERROR_INVALID_DATA)
 bstrPolicyServerId 매개 변수에 지정된 값은 NULL이 아니며 CEP 서버의 기존 CEP ID 값과 같지 않습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 certenroll.h

추가 정보

IX509EnrollmentPolicyServer