IX509PrivateKey::Export 메서드(certenroll.h)

Export 메서드는 프라이빗 키를 바이트 배열에 복사합니다. 바이트 배열은 유니코드로 인코딩된 문자열로 표시됩니다.

구문

HRESULT Export(
  [in]  BSTR         strExportType,
  [in]  EncodingType Encoding,
  [out] BSTR         *pstrEncodedKey
);

[in] strExportType

프라이빗 키를 내보내는 방법을 지정하는 BSTR 값입니다.

CNG KSP(키 스토리지 공급자)를 사용하여 키를 만든 경우 NCryptExportKey 함수에서 pszBlobType 매개 변수에서 허용하는 값 중 하나를 지정할 수 있습니다.

암호화 서비스 공급자(CryptoAPI CSP)를 사용하여 키를 만든 경우 Wincrypt.h에 포함된 Bcrypt.h 헤더 파일에서 다음 값 중 하나를 지정할 수 있습니다.

값	의미
BCRYPT_PUBLIC_KEY_BLOB	프라이빗 키의 공용 부분만 내보냅니다.
BCRYPT_PRIVATE_KEY_BLOB	전체 프라이빗 키를 내보냅니다.

[in] Encoding

pstrEncodedKey 매개 변수에 포함된 문자열에 적용할 유니코드 인코딩의 형식을 지정하는 EncodingType 열거형 값입니다. 기본값은 XCN_CRYPT_STRING_BASE64.

[out] pstrEncodedKey

프라이빗 키가 포함된 BSTR 변수에 대한 포인터입니다.

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

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

반환 코드	설명
HRESULT_FROM_WIN32(ERROR_CALL_NOT_IMPLEMENTED)	Key는 CryptoAPI CSP에 의해 만들어졌으며 strExportType 매개 변수에 대한 BCRYPT_PRIVATE_KEY_BLOB 또는 BCRYPT_PUBLIC_KEY_BLOB 이외의 값을 지정했습니다.