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 요청이 위와 같이 생성되고 다음 개체가 초기화됩니다.

빈 ICryptAttributes 컬렉션입니다.
빈 IX509NameValuePairs 컬렉션입니다.
빈 IX509Extensions 컬렉션입니다.
기본 중요 확장 개체 식별자, XCN_OID_KEY_USAGE 및 XCN_OID_BASIC_CONSTRAINTS2 포함하는 IObjectIds 컬렉션입니다. 이 컬렉션은 CriticalExtensions 속성을 호출하여 검색할 수 있습니다.
SuppressOids 속성에 대한 빈 IObjectIds 컬렉션입니다.
빈 ISignerCertificates 컬렉션입니다.

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

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

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