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

Import 메서드는 기존 프라이빗 키를 암호화 공급자 내의 키 컨테이너로 가져옵니다.

구문

HRESULT Import(
  [in] BSTR         strExportType,
  [in] BSTR         strEncodedKey,
  [in] EncodingType Encoding
);

[in] strExportType

CNG KSP(키 스토리지 공급자)를 사용하여 키를 만든 경우 Import 메서드는 NCryptSetProperty 함수의 pszProperty 매개 변수에 이 인수를 전달합니다. 즉, 지정한 값은 가져온 키에 설정할 속성의 이름으로 사용됩니다.

CryptoAPI CSP(암호화 서비스 공급자)를 사용하여 키를 만든 경우 이 인수는 프라이빗 키를 가져오는 방법을 지정합니다. 이 값은 다음 값일 수 있습니다.

값	의미
BCRYPT_PRIVATE_KEY_BLOB	전체 프라이빗 키를 가져옵니다.

[in] strEncodedKey

가져올 키가 포함된 BSTR 변수입니다.

[in] Encoding

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

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

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

반환 코드	설명
HRESULT_FROM_WIN32(ERROR_FILE_READ_ONLY)	키 컨테이너가 이미 열려 있습니다. 열기 또는 만들기를 이미 호출한 경우 이 오류가 발생할 수 있습니다.
HRESULT_FROM_WIN32(ERROR_CALL_NOT_IMPLEMENTED)	Key는 CryptoAPI CSP에 의해 만들어졌으며 strExportType 매개 변수에 대해 BCRYPT_PRIVATE_KEY_BLOB 이외의 값을 지정했습니다.

Import 함수는 strExportType 매개 변수에 BCRYPT_PRIVATE_KEY_BLOB 이외의 값을 지정하고 다음 속성을 설정하지 않으면 CNG KSP 키를 가져오려고 시도한다고 자동으로 가정합니다.