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 |