CryptUIWizExport-Funktion (cryptuiapi.h)

Artikel
08/22/2023

Die CryptUIWizExport-Funktion exportiert ein Zertifikat, eine Zertifikatvertrauensliste (Certificate Trust List , CTL), eine Zertifikatsperrliste (Certificate Revocation List , CRL) oder einen Zertifikatspeicher in eine Datei. Der Export kann mit oder ohne Benutzerinteraktion ausgeführt werden.

Syntax

BOOL CryptUIWizExport(
  [in] DWORD                     dwFlags,
  [in] HWND                      hwndParent,
  [in] LPCWSTR                   pwszWizardTitle,
  [in] PCCRYPTUI_WIZ_EXPORT_INFO pExportInfo,
  [in] void                      *pvoid
);

Parameter

[in] dwFlags

Enthält Flags, die das Verhalten der Funktion ändern. Dies kann null oder eine Kombination aus einem oder mehreren der folgenden Werte sein.

Hinweis Mit Ausnahme von CRYPTUI_WIZ_NO_UI wird keine der folgenden Konstanten in einer veröffentlichten Headerdatei definiert. Um diese Konstanten zu verwenden, müssen Sie sie mit den angegebenen Werten definieren.

Wert	Bedeutung
CRYPTUI_WIZ_NO_UI 0x0001	Diese Funktion führt den Export basierend auf den Informationen in der CRYPTUI_WIZ_EXPORT_INFO Struktur aus, auf die pExportInfo verweist, ohne dass eine Benutzeroberfläche angezeigt wird. Wenn dieses Flag nicht angegeben ist, zeigt diese Funktion einen Assistenten an, der den Benutzer durch den Exportprozess führt.
CRYPTUI_WIZ_IGNORE_NO_UI_FLAG_FOR_CSPS 0x0002	Unterdrücken sie alle Benutzeroberflächen, die von Kryptografiedienstanbietern (Cryptographic Service Provider , CSPs) generiert werden. Diese Option kann von der Option CRYPTUI_WIZ_NO_UI_EXCEPT_CSP überschrieben werden.
CRYPTUI_WIZ_NO_UI_EXCEPT_CSP 0x0003	Unterdrücken Sie alle Benutzeroberflächen mit Ausnahme der benutzeroberflächen, die von CSPs generiert wurden. Mit dieser Option wird die option CRYPTUI_WIZ_IGNORE_NO_UI_FLAG_FOR_CSPS außer Kraft gesetzt.
CRYPTUI_WIZ_EXPORT_PRIVATE_KEY 0x0100	Überspringen Sie die Seite Privaten Schlüssel exportieren , und gehen Sie davon aus, dass der private Schlüssel exportiert werden soll.
CRYPTUI_WIZ_EXPORT_NO_DELETE_PRIVATE_KEY 0x0200	Deaktivieren Sie das Kontrollkästchen Privaten Schlüssel löschen auf der Seite Dateiformat exportieren .

[in] hwndParent

Das Handle des Fensters, das als übergeordnetes Element des Dialogfelds verwendet werden soll, das von dieser Funktion erstellt wird. Dieser Parameter wird ignoriert, wenn das CRYPT_WIZ_NO_UI-Flag in dwFlags festgelegt ist.

[in] pwszWizardTitle

Ein Zeiger auf eine Unicode-Zeichenfolge mit Null-Beendigung, die den Titel enthält, der im Dialogfeld verwendet werden soll, das von dieser Funktion erstellt wird. Dieser Parameter wird ignoriert, wenn das CRYPT_WIZ_NO_UI-Flag in dwFlags festgelegt ist.

[in] pExportInfo

Ein Zeiger auf eine CRYPTUI_WIZ_EXPORT_INFO-Struktur , die Informationen zum Erstellen des Export-Assistenten enthält.

[in] pvoid

Wenn das dwSubjectChoice-Element der CRYPTUI_WIZ_EXPORT_INFO Struktur, auf die pExportInfo verweist, CRYPTUI_WIZ_EXPORT_CERT_CONTEXT ist und das CRYPTUI_WIZ_NO_UI-Flag in dwFlags festgelegt ist, ist dieser Parameter ein Zeiger auf eine CRYPTUI_WIZ_EXPORT_CERTCONTEXT_INFO Struktur.

Wenn das CRYPTUI_WIZ_NO_UI-Flag in dwFlags nicht festgelegt ist, ist dieser Parameter optional und kann NULL sein. Wenn dieser Parameter nicht NULL ist, enthält die CRYPTUI_WIZ_EXPORT_CERTCONTEXT_INFO-Struktur die Werte, die dem Benutzer als Standardoptionen angezeigt werden.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion nonzero zurück.

Wenn die Funktion fehlschlägt, gibt sie null zurück. Rufen Sie die GetLastError-Funktion auf, um erweiterte Fehlerinformationen zu erhalten.

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	cryptuiapi.h
Bibliothek	Cryptui.lib
DLL	Cryptui.dll

Weitere Informationen

CRYPTUI_WIZ_EXPORT_CERTCONTEXT_INFO

CRYPTUI_WIZ_EXPORT_INFO

CryptUIWizImport

Freigeben über