IEnroll4::createPFXWStr-Methode (xenroll.h)

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

Die createPFXWStr-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 IEnroll4-Schnittstelle definiert.

Syntax

HRESULT createPFXWStr(
  [in]  LPCWSTR          pwszPassword,
  [out] PCRYPT_DATA_BLOB pblobPFX
);

Parameter

[in] pwszPassword

Ein Zeiger auf eine Unicode-Zeichenfolge mit Null-Beendigung, die das Kennwort für die Nachricht im PFX-Format darstellt. Dieser Wert kann leer oder NULL sein, um anzugeben, dass kein Kennwort verwendet wird. Wenn Sie das Kennwort verwendet haben, entfernen Sie die vertraulichen Informationen aus dem Arbeitsspeicher, indem Sie SecureZeroMemory aufrufen. Weitere Informationen zum Schutz des Kennworts finden Sie unter Behandeln von Kennwörtern.

[out] pblobPFX

Ein Zeiger auf die CRYPT_DATA_BLOB-Struktur , die die Zertifikatinformationen des base64-codierten PFX-Formats empfängt.

Wenn Sie mit der Verwendung dieses Arbeitsspeichers fertig sind, geben Sie ihn frei, indem Sie das pbData-Element dieser Struktur an die CoTaskMemFree-Funktion übergeben.

Rückgabewert

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.

Anforderungen

Anforderung	Wert
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

Weitere Informationen

IEnroll4