IX509EnrollmentHelper::Enroll 메서드(certenroll.h)

Enroll 메서드는 인증서 요청을 등록하고 발급된 인증서를 검색합니다. 이 메서드는 웹을 사용할 수 있습니다.

구문

HRESULT Enroll(
  [in]          BSTR               strEnrollmentPolicyServerURI,
  [in]          BSTR               strTemplateName,
  [in]          EncodingType       Encoding,
  [in]          WebEnrollmentFlags enrollFlags,
  [out, retval] BSTR               *pstrCertificate
);

매개 변수

[in] strEnrollmentPolicyServerURI

인증서 등록 정책 서버 URL을 포함하는 BSTR 입니다.

[in] strTemplateName

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

[in] Encoding

표시를 위해 바이트 배열에 적용되는 인코딩 유형을 지정하는 EncodingType 열거형 값입니다.

[in] enrollFlags

웹 등록 동작을 지정하는 WebEnrollmentFlags 열거형 값입니다. 이 값은 다음 값일 수 있습니다.

값	의미
EnrollPrompt	이 플래그가 설정되어 있고 인증서 등록 서버에 인증 자격 증명을 사용할 수 없는 경우 인증서 서비스에서 자격 증명을 묻는 메시지를 표시합니다. 인증 자격 증명이 없고 이 플래그가 설정되지 않은 경우 Enroll 메서드가 실패합니다.

[out, retval] pstrCertificate

발급된 인증서를 포함하는 BSTR 입니다.

반환 값

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

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

반환 코드	설명
E_INVALIDARG	strEnrollmentPolicyServerURI 및 strTemplateName 매개 변수는 NULL일 수 없습니다.
HRESULT_FROM_WIN32(ERROR_ARITHMETIC_OVERFLOW)	strEnrollmentPolicyServerURI 및 strTemplateName 매개 변수가 64,000자를 초과하거나 포함된 null 문자를 포함합니다.

설명

Enroll 메서드는 적절한 템플릿을 검색하고 InitializeFromTemplate을 호출한 다음 IX509Enrollment 개체에서 등록을 호출합니다.

이 메서드는 발급된 인증서를 설치하지 않습니다.

요구 사항

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

추가 정보

IX509EnrollmentHelper