IX509CertificateRequestPkcs10::InitializeDecode 메서드(certenroll.h)

  • 아티클

InitializeDecode 메서드는 서명되거나 서명되지 않은 기존 PKCS #10 인증서 요청을 디코딩하고 이를 사용하여 새 PKCS #10 요청 개체를 초기화합니다. 기존 요청은 ASN.1(추상 구문 표기법 1) 표준에 정의된 대로 DER(Distinguished Encoding Rules)를 사용하여 인코딩된 바이트 배열에 포함되어 있습니다. 바이트 배열은 순수 이진 시퀀스이거나 유니코드 인코딩된 문자열로 표시됩니다.

구문

HRESULT InitializeDecode(
  [in] BSTR         strEncodedData,
  [in] EncodingType Encoding
);

매개 변수

[in] strEncodedData

DER로 인코딩된 요청을 포함하는 BSTR 변수입니다. 자세한 내용은 설명 부분을 참조하세요.

[in] Encoding

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

반환 값

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

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

반환 코드/값 설명
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
 인증서 요청 개체가 이미 초기화되었습니다.

설명

InitializeDecode 메서드는 기존 PKCS #10 요청을 디코딩하고 검색된 정보를 사용하여 새 요청 개체에 대해 다음 컬렉션을 초기화합니다.

메서드도 다음과 같습니다.

기본적으로 InitializeDecode 메서드는 디코딩할 인증서 요청이 최종 사용자를 위한 것이라고 가정합니다. Windows 8 및 Windows Server 2012 시작하여 이 기본 동작을 변경할 수 있습니다. IX509CertificateRequestPkcs10 인터페이스의 instance 만든 후 Encoding 매개 변수를 XCN_CRYPT_STRING_BINARY 로 설정하고 strEncodedData 매개 변수를 다음 값 중 하나로 설정하여 InitializeDecode를 호출합니다.

값 Description
L"ContextMachine" 인코딩된 인증서 요청은 컴퓨터에 대한 것입니다.
L"ContextUser" 인코딩된 인증서 요청은 최종 사용자를 위한 것입니다.
L"ContextAdministratorForceMachine" 인코딩된 인증서는 컴퓨터를 대신하여 행동하는 관리자가 요청합니다.
 

그런 다음 strEncodedData 인수에 인코딩된 인증서를 설정하여 InitializeDecode 메서드를 다시 호출합니다.

요구 사항

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

추가 정보

IX509CertificateRequestPkcs10