다음을 통해 공유


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

Initialize 메서드는 사용자 또는 컴퓨터에 대한 요청 개체를 초기화합니다.

구문

HRESULT Initialize(
  [in] X509CertificateEnrollmentContext Context
);

매개 변수

[in] Context

인증서가 최종 사용자, 컴퓨터 또는 컴퓨터를 대신하여 작동하는 관리자용인지 여부를 지정하는 X509CertificateEnrollmentContext 열거형 값입니다. 다음 값 중 하나일 수 있습니다.

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

반환 값

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

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

반환 코드 설명
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
개체가 이미 초기화되어 있습니다.

설명

Initialize 메서드는 생성되는 인증서 요청 유형에 따라 다양한 개체를 초기화합니다. IX509CertificateRequestPkcs10 개체에서 이 메서드를 호출하면 프라이빗 키 개체가 만들어지고 다음 개체가 초기화됩니다.

  • ICryptAttributes 컬렉션입니다.
  • IX509Extensions 컬렉션입니다.
  • 기본 중요 확장 개체 식별자, XCN_OID_KEY_USAGE 및 XCN_OID_BASIC_CONSTRAINTS2 포함하는 IObjectIds 컬렉션입니다. 이 컬렉션은 CriticalExtensions 속성을 호출하여 검색할 수 있습니다.
  • SuppressOids 속성에 대한 빈 IObjectIds 컬렉션입니다.
  • CSPInformations 속성에 지정한 값 또는 컴퓨터에 설치된 모든 공급자의 컬렉션을 포함하는 ICspInformations 개체입니다. 이 컬렉션은 프라이빗 키를 만드는 데 사용됩니다.

IX509CertificateRequestCmc 개체에서 이 메서드를 호출하면 내부 PKCS #10 요청이 위와 같이 생성되고 다음 개체가 초기화됩니다.

IX509CertificateRequestPkcs7 개체에서 이 메서드를 호출하면 내부 PKCS #10 요청이 위와 같이 만들어집니다.

이 메서드를 호출하기 전에 다음 속성을 호출할 수 있습니다.

ICspInformations 컬렉션을 지정하려면 이 메서드를 호출하기 전에 CSPInformations 속성을 호출해야 합니다.

요구 사항

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

추가 정보

IX509CertificateRequest

IX509CertificateRequestCertificate

IX509CertificateRequestCmc

IX509CertificateRequestPkcs10

IX509CertificateRequestPkcs7

IX509SignatureInformation