다음을 통해 공유

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

  • 아티클

Initialize 메서드는 인증서 요청 ID, CA(인증 기관) 구성 문자열 및 선택적 인증서 표시 이름에서 속성을 초기화합니다.

구문

HRESULT Initialize(
  [in]           LONG RequestId,
  [in]           BSTR strCADnsName,
  [in]           BSTR strCAName,
  [in, optional] BSTR strFriendlyName
);

매개 변수

[in] RequestId

인증서 요청 ID를 포함하는 LONG 변수입니다. 요청 ID는 등록 프로세스에 의해 만들어집니다. IX509Enrollment 인터페이스에서 RequestId 속성을 호출하여 이 값을 검색할 수 있습니다.

[in] strCADnsName

CA의 DNS(Domain Name System) 이름을 포함하는 BSTR 변수입니다. CADnsName\CAName CA 구성 문자열의 이름입니다. 구성 문자열은 일반적으로 등록 프로세스 중에 설정됩니다. DNS 이름은 CAConfigString 속성을 호출하고 문자열을 해당 구성 요소로 구분하여 검색할 수 있습니다.

[in] strCAName

CA의 CN(주체 일반 이름)을 포함하는 BSTR 변수입니다. CADnsName\CAName CA 구성 문자열의 두 번째 이름입니다. 구성 문자열은 일반적으로 등록 프로세스 중에 설정됩니다. CN 이름은 CAConfigString 속성을 호출하고 문자열을 해당 구성 요소로 구분하여 검색할 수 있습니다.

[in, optional] strFriendlyName

인증서의 선택적 표시 이름을 포함하는 BSTR 변수입니다. 기본값은 NULL입니다. 이 값은 일반적으로 등록 프로세스 중에 설정됩니다. CertificateFriendlyName 속성을 호출하여 검색할 수 있습니다.

반환 값

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

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

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

설명

ICertPropertyEnrollment 개체를 초기화하는 데 사용할 수 있는 값은 클라이언트가 IX509Enrollment 개체에서 Enroll 메서드를 호출할 때 인증서 등록 프로세스 중에 설정됩니다. 즉, 요청 ID를 검색하려면 IX509Enrollment 개체에서 RequestId 속성을 호출합니다. 인증서 표시 이름을 검색하려면 CertificateFriendlyName 속성을 호출합니다. 고유 이름과 일반 이름을 검색하려면 CAConfigString 속성을 호출하고 구성 문자열을 구성 요소로 구분합니다.

SetValueOnCertificate 메서드를 호출하여 속성을 인증서와 연결합니다. 다음 속성을 호출하여 초기화 중에 지정된 값을 검색할 수도 있습니다.

요구 사항

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

추가 정보

ICertProperty

ICertPropertyEnrollment