다음을 통해 공유


IX509CertificateRequestPkcs10::InitializeFromTemplateName 메서드(certenroll.h)

InitializeFromTemplateName 메서드는 템플릿을 사용하여 인증서 요청을 초기화합니다.

구문

HRESULT InitializeFromTemplateName(
  [in] X509CertificateEnrollmentContext Context,
  [in] BSTR                             strTemplateName
);

매개 변수

[in] Context

요청된 인증서가 컴퓨터를 대신하여 작동하는 최종 사용자, 컴퓨터 또는 관리자를 위한 것인지 여부를 지정하는 X509CertificateEnrollmentContext 열거형 값입니다.

[in] strTemplateName

Active Directory 또는 점선 10진수 개체 식별자에 나타나는 템플릿의 CN(일반 이름)을 포함하는 BSTR 변수입니다.

반환 값

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

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

반환 코드/값 설명
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
인증서 요청 개체가 이미 초기화되었습니다.

설명

InitializeFromTemplateName 메서드는 다음 컬렉션을 만듭니다.

  • ICryptAttributes 컬렉션입니다.
  • IX509Extensions 컬렉션입니다.
  • 기본 XCN_OID_KEY_USAGE 및 XCN_OID_BASIC_CONSTRAINTS2 개체 식별자가 채워진 IObjectIds 컬렉션입니다.
  • 새 요청에서 표시하지 않을 특성 및 확장 OID에 대한 빈 IObjectIds 컬렉션입니다.

그런 다음 메서드는 템플릿을 검사하고 다음 작업을 수행합니다.

CSPInformations 속성이 NULL이면 메서드는 컴퓨터에 설치된 공급자로부터 ICspInformations 컬렉션을 만듭니다.

요구 사항

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

추가 정보

IX509CertificateRequestPkcs10