다음을 통해 공유

IX509Enrollment::CreateRequest 메서드(certenroll.h)

  • 아티클

CreateRequest 메서드는 인코딩된 인증서 요청을 검색합니다. 인증서 요청은 ASN.1(Abstract Syntax Notation One) 표준에 정의된 대로 DER(Distinguished Encoding Rules)를 사용하여 인코딩되는 바이트 배열에 포함됩니다. DER로 인코딩된 바이트 배열은 순수 이진 시퀀스 또는 유니코드로 인코딩된 문자열로 표시됩니다. 이 메서드는 웹을 사용할 수 있습니다.

구문

HRESULT CreateRequest(
  [in]  EncodingType Encoding,
  [out] BSTR         *pValue
);

매개 변수

[in] Encoding

DER로 인코딩된 요청에 적용된 유니코드 인코딩 유형을 지정하는 EncodingType 열거형 값입니다. 기본값은 XCN_CRYPT_STRING_BASE64.

[out] pValue

DER로 인코딩된 요청을 포함하는 BSTR 변수에 대한 포인터입니다.

반환 값

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

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

반환 코드/값 설명
CERTSRV_E_PROPERTY_EMPTY
 인증서 요청을 찾을 수 없습니다.
OLE_E_BLANK
 등록 개체가 초기화되지 않았습니다.

설명

CreateRequest 메서드는 필요한 경우 Encode 메서드를 호출하여 연결된 요청 개체의 원시 데이터를 인코딩합니다.

이 메서드는 초기화 중에 제공된 정보 및 지정된 기타 속성을 사용하여 더미 인증서를 만들고 요청 저장소에 배치합니다. 또한 메서드는 필요한 경우 키 쌍을 만듭니다. 등록 개체를 초기화하는 방법과 설정한 속성에 따라 키 쌍을 만들 필요가 없습니다. 예를 들어 기존 키를 사용하여 인증서를 갱신하거나 인증서 요청과 연결된 IX509PrivateKey 개체가 기존 키를 나타내는 경우 이 메서드는 새 키 쌍을 만들지 않습니다.

스마트 카드가 관련된 경우 이 메서드는 외부 속성을 확장으로 인코딩하고 더미 인증서에 포함하며 더미 인증서를 스마트 카드 키 컨테이너에 씁니다. 스마트 카드 로그온 인증서는 개인 저장소가 아닌 요청 저장소로 인코딩됩니다.

CreateRequest 메서드를 호출하기 전에 다음 메서드 중 하나를 호출하여 IX509Enrollment 개체를 초기화해야 합니다.

요구 사항

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

추가 정보

IX509CertificateRequest

IX509등록