PCRYPT_DECRYPT_PRIVATE_KEY_FUNC 콜백 함수(wincrypt.h)

  • 아티클

[ PCRYPT_DECRYPT_PRIVATE_KEY_FUNC 함수는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다.]

PCRYPT_DECRYPT_PRIVATE_KEY_FUNC 함수는 프라이빗 키의 암호를 해독하고 pbClearTextKey 매개 변수에서 암호 해독된 키를 반환합니다. PCRYPT_DECRYPT_PRIVATE_KEY_FUNCCRYPT_PKCS8_IMPORT_PARAMS 구조에 지정된 콜백 함수입니다. CRYPT_ENCRYPTED_PRIVATE_KEY_INFO 구조에 암호를 해독해야 하는 프라이빗 키가 포함된 경우에 사용됩니다. CryptImportPKCS8 함수는 이 함수를 사용합니다. 각 애플리케이션에 맞게 개발자가 함수를 구현해야 합니다.

구문

PCRYPT_DECRYPT_PRIVATE_KEY_FUNC PcryptDecryptPrivateKeyFunc;

BOOL PcryptDecryptPrivateKeyFunc(
  [in]      CRYPT_ALGORITHM_IDENTIFIER Algorithm,
  [in]      CRYPT_DATA_BLOB EncryptedPrivateKey,
  [out]     BYTE *pbClearTextKey,
  [in, out] DWORD *pcbClearTextKey,
  [in]      LPVOID pVoidDecryptFunc
)
{...}

매개 변수

[in] Algorithm

PKCS #8 표준에 있는 PrivateKeyInfo ASN.1 형식을 암호화하는 데 사용되는 알고리즘을 식별하는 CRYPT_ALGORITHM_IDENTIFIER 구조체입니다.

[in] EncryptedPrivateKey

암호화된 프라이빗 키 BLOB을 식별하는 CRYPT_DATA_BLOB 값입니다.

[out] pbClearTextKey

일반 텍스트를 받을 BYTE 버퍼에 대한 포인터입니다. 이 매개 변수는 NULL일 수 있습니다. 자세한 내용은 알 수 없는 길이의 데이터 검색을 참조하세요.

[in, out] pcbClearTextKey

pbClearTextKey 버퍼의 크기(바이트)를 식별하는 DWORD 값에 대한 포인터입니다. 크기가 0인 경우 pcbClearTextKey 는 키 암호를 해독하는 데 필요한 크기(바이트)로 채워져야 하며 pbClearTextKey 는 무시해야 합니다.

[in] pVoidDecryptFunc

키, 초기화 벡터 및 암호와 같은 암호 해독에 사용되는 데이터를 제공하는 LPVOID 값입니다.

반환 값

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

함수가 실패하면 0(FALSE)을 반환합니다.

요구 사항

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

추가 정보

CRYPT_ENCRYPTED_PRIVATE_KEY_INFO

CRYPT_PKCS8_IMPORT_PARAMS

CryptImportPKCS8