CRYPT_PKCS8_EXPORT_PARAMS-Struktur (wincrypt.h)

Artikel
08/27/2023

[Die CRYPT_PKCS8_EXPORT_PARAMS-Struktur steht für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen zur Verfügung. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]

Die CRYPT_PKCS8_EXPORT_PARAMS-Struktur identifiziert den privaten Schlüssel und eine Rückruffunktion zum Verschlüsseln des privaten Schlüssels. CRYPT_PKCS8_EXPORT_PARAMS wird als Parameter für die
CryptExportPKCS8Ex-Funktion , die einen privaten Schlüssel im PKCS #8-Format exportiert.

Syntax

typedef struct _CRYPT_PKCS8_EXPORT_PARAMS {
  HCRYPTPROV                      hCryptProv;
  DWORD                           dwKeySpec;
  LPSTR                           pszPrivateKeyObjId;
  PCRYPT_ENCRYPT_PRIVATE_KEY_FUNC pEncryptPrivateKeyFunc;
  LPVOID                          pVoidEncryptFunc;
} CRYPT_PKCS8_EXPORT_PARAMS, *PCRYPT_PKCS8_EXPORT_PARAMS;

Member

hCryptProv

Eine HCRYPTPROV-Variable , die ein Handle für den Kryptografiedienstanbieter (Cryptographic Service Provider , CSP) enthält, der zum Verschlüsseln des privaten Schlüssels verwendet wird. Dies ist ein Handle für den CSP, der durch Aufrufen von CryptAcquireContext abgerufen wird.

dwKeySpec

Eine DWORD-Variable , die die Schlüsselspezifikation enthält. Die folgenden dwKeySpec-Werte sind für den Standardanbieter definiert.

Wert	Bedeutung
AT_KEYEXCHANGE	Schlüssel, die zum Verschlüsseln/Entschlüsseln von Sitzungsschlüsseln verwendet werden.
AT_SIGNATURE	Schlüssel, die zum Erstellen und Überprüfen digitaler Signaturen verwendet werden.

pszPrivateKeyObjId

Eine LPSTR-Variable , die den Objektbezeichner (Object Identifier, OID) des zu exportierenden privaten Schlüssels enthält.

pEncryptPrivateKeyFunc

Ein PCRYPT_ENCRYPT_PRIVATE_KEY_FUNC Zeiger, der auf einen Rückruf auf eine Funktion verweist, die den privaten Schlüssel verschlüsselt. Wenn dies NULL ist, wird der private Schlüssel nicht verschlüsselt, und eine PKCS #8 CRYPT_ENCRYPTED_PRIVATE_KEY_INFO-Struktur wird von CryptExportPKCS8Ex nicht generiert.

pVoidEncryptFunc

Ein LPVOID-Wert , der daten bereitstellt, die für die Verschlüsselung verwendet werden, z. B. Schlüssel, Initialisierungsvektor und Kennwort.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	wincrypt.h

Weitere Informationen

CRYPT_ENCRYPTED_PRIVATE_KEY_INFO

CryptAcquireContext

CryptExportPKCS8Ex

PCRYPT_ENCRYPT_PRIVATE_KEY_FUNC

Freigeben über