CryptImportPublicKeyInfoEx2 함수(wincrypt.h)

  • 아티클

CryptImportPublicKeyInfoEx2 함수는 공개 키를 OID(공개 키개체 식별자)에 해당하는 CNG 비대칭 공급자로 가져오고 키에 CNG 핸들을 반환합니다.

구문

BOOL CryptImportPublicKeyInfoEx2(
  [in]  DWORD                 dwCertEncodingType,
  [in]  PCERT_PUBLIC_KEY_INFO pInfo,
  [in]  DWORD                 dwFlags,
  [in]  void                  *pvAuxInfo,
  [out] BCRYPT_KEY_HANDLE     *phKey
);

매개 변수

[in] dwCertEncodingType

주체를 암호화하는 데 사용된 인증서 인코딩 형식 입니다. 이 값의 높은 WORD에 포함된 메시지 인코딩 형식 식별자는 이 함수에서 무시됩니다.

이 매개 변수는 현재 정의된 다음 인증서 인코딩 형식일 수 있습니다.

값 의미
X509_ASN_ENCODING
1(0x1)
 X.509 인증서 인코딩을 지정합니다.

[in] pInfo

공급자로 가져올 공개 키 정보를 포함하는 CERT_PUBLIC_KEY_INFO 구조체의 주소입니다.

[in] dwFlags

이 함수의 동작을 수정하는 플래그 집합입니다. 이 값은 0이거나 다음 값 중 하나 이상의 조합일 수 있습니다.

값 의미
CRYPT_OID_INFO_PUBKEY_SIGN_KEY_FLAG
 CRYPT_OID_PUBKEY_ENCRYPT_ONLY_FLAG 플래그로 명시적으로 플래그가 지정된 CRYPT_PUBKEY_ALG_OID_GROUP_ID 그룹의 공개 키를 건너뜁니다.
CRYPT_OID_INFO_PUBKEY_ENCRYPT_KEY_FLAG
 CRYPT_OID_PUBKEY_SIGN_ONLY_FLAG 플래그로 명시적으로 플래그가 지정된 CRYPT_PUBKEY_ALG_OID_GROUP_ID 그룹의 공개 키를 건너뜁니다.
 

이러한 플래그는 공개 키 개체 식별자를 해당 CNG 공개 키 알고리즘 식별자에 매핑할 때 CryptFindOIDInfo 함수의 dwKeyType 매개 변수에 전달됩니다.

[in] pvAuxInfo

이 매개 변수는 나중에 사용하도록 예약되어 있으며 NULL로 설정해야 합니다.

[out] phKey

가져온 키의 핸들을 수신하는 BCRYPT_KEY_HANDLE 변수의 주소입니다.

이 핸들이 더 이상 필요하지 않은 경우 BCryptDestroyKey 함수를 호출하여 해제해야 합니다.

반환 값

함수가 성공하면 함수는 0이 아닌 값(TRUE)을 반환합니다.

함수가 실패하면 0(FALSE)을 반환합니다. 확장 오류 정보는 GetLastError를 호출합니다. 가능한 오류 코드에는 다음이 포함되지만 이에 국한되지는 않습니다.

반환 코드 설명
ERROR_FILE_NOT_FOUND
 지정된 dwCertEncodingType 및 pInfo 매개 변수에 대해 설치하거나 등록할 수 있는 가져오기 함수를 찾을 수 없습니다.
E_INVALIDARG
 하나 이상의 매개 변수가 유효하지 않습니다.

요구 사항

   
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 wincrypt.h
라이브러리 Crypt32.lib
DLL Crypt32.dll

추가 정보

CERT_PUBLIC_KEY_INFO