IX509Enrollment2::InitializeFromTemplate 메서드(certenroll.h)

InitializeFromTemplate 메서드는 템플릿을 사용하여 등록 개체를 초기화합니다.

구문

HRESULT InitializeFromTemplate(
  [in] X509CertificateEnrollmentContext context,
  [in] IX509EnrollmentPolicyServer      *pPolicyServer,
  [in] IX509CertificateTemplate         *pTemplate
);

매개 변수

[in] context

요청된 등록이 컴퓨터 대신 작동하는 사용자, 컴퓨터 또는 관리자에 대한 등록인지 여부를 나타내는 X509CertificateEnrollmentContext 열거형 값입니다. 다음 값 중 하나일 수 있습니다.

값	의미
ContextUser	최종 사용자에 대해 인증서가 요청되고 있습니다.
ContextMachine	컴퓨터에 대해 인증서가 요청되고 있습니다.
ContextAdministratorForceMachine	컴퓨터 대신 작동하는 관리자가 인증서를 요청합니다.

[in] pPolicyServer

pTemplate 매개 변수로 지정된 템플릿을 포함하는 CEP(인증서 등록 정책) 서버를 나타내는 IX509EnrollmentPolicyServer 개체에 대한 포인터입니다.

[in] pTemplate

초기화 중에 사용할 템플릿을 나타내는 IX509CertificateTemplate 개체에 대한 포인터입니다.

반환 값

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

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

반환 코드/값	설명
E_POINTER	pPolicyServer 및 pTemplate 매개 변수는 NULL일 수 없습니다.
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	등록 개체가 이미 초기화되었습니다.

설명

InitializeFromTemplate 메서드:

• 템플릿을 검사하여 필요한 요청 유형을 확인합니다.
• 적절한 유형의 요청 개체(PKCS #10, PKCS #7 또는 CMC)를 만듭니다.
• 값이 현재 있는 경우 요청에 다음 속성을 설정합니다.
  • CspInformations
  • ParentWindow
  • 자동
• 템플릿을 사용하여 요청 개체를 초기화합니다.
• 템플릿에서 서명 수, 발급 정책 및 애플리케이션 정책을 검색합니다.

요구 사항

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

추가 정보

IX509Enrollment2