ICEnroll4::createPFX-Methode (xenroll.h)

Artikel
08/28/2023

[Diese Methode steht ab Windows Server 2008 und Windows Vista nicht mehr zur Verfügung.]

Die createPFX-Methode speichert die akzeptierte Zertifikatkette und den privaten Schlüssel in einer PFX-Formatzeichenfolge (Personal Information Exchange). Das PFX-Format wird auch als PKCS #12 bezeichnet.

Diese Methode wurde zuerst in der ICEnroll4-Schnittstelle definiert.

Syntax

HRESULT createPFX(
  [in]  BSTR strPassword,
  [out] BSTR *pstrPFX
);

Parameter

[in] strPassword

Ein Kennwort für die Nachricht im PFX-Format. Dieser Wert kann leer oder NULL sein, um anzugeben, dass kein Kennwort verwendet wird. Wenn Sie das Kennwort verwendet haben, löschen Sie es aus dem Arbeitsspeicher, indem Sie die SecureZeroMemory-Funktion aufrufen. Weitere Informationen zum Schutz des Kennworts finden Sie unter Behandeln von Kennwörtern.

[out] pstrPFX

Ein Zeiger auf einen BSTR , der die Zertifikatinformationen im Base64-codierten PFX-Format empfängt. Wenn Sie die Verwendung des BSTR abgeschlossen haben, geben Sie ihn frei, indem Sie die SysFreeString-Funktion aufrufen.

Rückgabewert

C++

Wenn die Methode erfolgreich ist, gibt die Methode S_OK zurück.

Wenn die Methode fehlschlägt, gibt sie einen HRESULT-Wert zurück, der den Fehler angibt. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

VB

Der Rückgabewert ist eine Zeichenfolge , die die Zertifikatinformationen im PFX-Format enthält.

Hinweise

Diese Methode ist deaktiviert, wenn das Zertifikatregistrierungssteuerelement als skriptbasiertes Steuerelement ausgeführt wird.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	xenroll.h
Bibliothek	Uuid.lib
DLL	Xenroll.dll

Freigeben über