PCRYPT_DECRYPT_PRIVATE_KEY_FUNC Rückruffunktion (wincrypt.h)

[Die PCRYPT_DECRYPT_PRIVATE_KEY_FUNC-Funktion ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]

Die PCRYPT_DECRYPT_PRIVATE_KEY_FUNC-Funktion entschlüsselt den privaten Schlüssel und gibt den entschlüsselten Schlüssel im Parameter pbClearTextKey zurück. PCRYPT_DECRYPT_PRIVATE_KEY_FUNC ist eine Rückruffunktion, die in einer CRYPT_PKCS8_IMPORT_PARAMS-Struktur angegeben ist. Es wird verwendet, wenn eine CRYPT_ENCRYPTED_PRIVATE_KEY_INFO-Struktur einen privaten Schlüssel enthält, der entschlüsselt werden muss. Die CryptImportPKCS8-Funktion verwendet diese Funktion. Die Funktion muss vom Entwickler für jede Anwendung implementiert werden.

Syntax

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
)
{...}

Parameter

[in] Algorithm

Eine CRYPT_ALGORITHM_IDENTIFIER-Struktur , die den Algorithmus identifiziert, der zum Verschlüsseln des PrivateKeyInfo ASN.1-Typs im PKCS #8-Standard verwendet wird.

[in] EncryptedPrivateKey

Ein CRYPT_DATA_BLOB Wert, der das BLOB für verschlüsselten privaten Schlüssel identifiziert.

[out] pbClearTextKey

Ein Zeiger auf einen BYTE-Puffer , um den Klartext zu empfangen. Dieser Parameter kann NULL sein. Weitere Informationen finden Sie unter Abrufen von Daten unbekannter Länge.

[in, out] pcbClearTextKey

Ein Zeiger auf einen DWORD-Wert , der die Größe des Puffers pbClearTextKey in Bytes angibt. Wenn die Größe 0 ist, sollte pcbClearTextKey mit der Größe in Bytes gefüllt werden, die zum Entschlüsseln des Schlüssels erforderlich ist, und pbClearTextKey sollte ignoriert werden.

[in] pVoidDecryptFunc

Ein LPVOID-Wert , der bei der Entschlüsselung verwendete Daten wie Schlüssel, Initialisierungsvektor und Kennwort bereitstellt.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion nonzero (TRUE) zurück.

Wenn die Funktion fehlschlägt, gibt sie null (FALSE) zurück.

Anforderungen

Weitere Informationen

CRYPT_ENCRYPTED_PRIVATE_KEY_INFO

CRYPT_PKCS8_IMPORT_PARAMS

CryptImportPKCS8