PFXExportCertStore-Funktion (wincrypt.h)

Die PFXExportCertStore-Funktion exportiert die Zertifikate und, sofern verfügbar, die zugeordneten privaten Schlüssel aus dem Zertifikatspeicher, auf den verwiesen wird. Dies ist eine alte Funktion, die zur Kompatibilität mit Internet Explorer 4.0-Clients beibehalten wird. Neue Anwendungen sollten die PfxExportCertStoreEx-Funktion verwenden, die erweiterte Sicherheit für private Schlüssel bietet.

Syntax

BOOL PFXExportCertStore(
  [in]      HCERTSTORE      hStore,
  [in, out] CRYPT_DATA_BLOB *pPFX,
  [in]      LPCWSTR         szPassword,
  [in]      DWORD           dwFlags
);

Parameter

[in] hStore

Handle des Zertifikatspeichers, der die zu exportierenden Zertifikate enthält.

[in, out] pPFX

Ein Zeiger auf eine CRYPT_DATA_BLOB Struktur, die das PFX-Paket mit den exportierten Zertifikaten und Schlüsseln enthält. Wenn pPFX-pbData>NULL ist, berechnet die Funktion die Anzahl der Bytes, die für das codierte BLOB benötigt werden, und gibt diese inpPFX-cbData> zurück. Wenn die Funktion aufgerufen wird, wobei pPFX-pbData> auf einen zugeordneten Puffer der erforderlichen Größe verweist, kopiert die Funktion die codierten Bytes in den Puffer und aktualisiert pPFX-cbData> mit der Codierungsbytelänge.

[in] szPassword

Zeichenfolgenkennwort, das zum Verschlüsseln und Überprüfen des PFX-Pakets verwendet wird. Wenn Sie das Kennwort verwendet haben, löschen Sie das Kennwort aus dem Arbeitsspeicher, indem Sie die SecureZeroMemory-Funktion aufrufen. Weitere Informationen zum Schutz von Kennwörtern finden Sie unter Behandeln von Kennwörtern.

[in] dwFlags

Flagwerte können auf eine beliebige Kombination der folgenden Werte festgelegt werden.

Rückgabewert

Gibt TRUE (nonzero) zurück, wenn die Funktion erfolgreich ist, und FALSE (null), wenn die Funktion fehlschlägt. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten.

Anforderungen

Weitere Informationen

PFXExportCertStoreEx

PFXImportCertStore