CryptUIWizImport-Funktion (cryptuiapi.h)

Artikel
02/24/2024

Die Funktion importiert ein Zertifikat, eine Zertifikatvertrauensliste (Certificate Trust List , CTL), eine Zertifikatsperrliste (Certificate Revocation List , CRL) oder einen Zertifikatspeicher in einen Zertifikatspeicher. Der Import kann mit oder ohne Benutzerinteraktion durchgeführt werden.

Syntax

BOOL CryptUIWizImport(
  [in] DWORD                         dwFlags,
  [in] HWND                          hwndParent,
  [in] LPCWSTR                       pwszWizardTitle,
  [in] PCCRYPTUI_WIZ_IMPORT_SRC_INFO pImportSrc,
  [in] HCERTSTORE                    hDestCertStore
);

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 Import basierend auf den Informationen in der CRYPTUI_WIZ_IMPORT_SRC_INFO Struktur, auf die pImportSrc verweist, in den von hDestCertStore angegebenen Speicher aus, ohne dass eine Benutzeroberfläche angezeigt wird. Wenn dieses Flag nicht angegeben ist, zeigt diese Funktion einen Assistenten an, der den Benutzer durch den Importprozess führt. Ab Windows 8 und Windows Server 2012: Wenn Sie dieses Flag festlegen und ein Zertifikat aus einem PFX-BLOB importieren, das für einen Active Directory-Prinzipal (AD) geschützt war und der aktuelle Benutzer als Teil dieses Prinzipals über die Berechtigung zum Entschlüsseln des im PFX-Paket eingebetteten Kennworts verfügt, ist der Import erfolgreich, ohne dass ein Kennwort im CRYPTUI_WIZ_IMPORT_SRC_INFO Struktur. Weitere Informationen zum Schutz von PFX in einem AD-Prinzipal finden Sie im PvPara-Parameter und im PKCS12_PROTECT_TO_DOMAIN_SIDS-Flag der PFXExportCertStoreEx-Funktion .
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_IMPORT_ALLOW_CERT 0x00020000	Lassen Sie den Import von Zertifikaten zu.
CRYPTUI_WIZ_IMPORT_ALLOW_CRL 0x00040000	Zulassen, dass CrLs importiert werden.
CRYPTUI_WIZ_IMPORT_ALLOW_CTL 0x00080000	Zulassen, dass CTLs importiert werden.
CRYPTUI_WIZ_IMPORT_NO_CHANGE_DEST_STORE 0x00010000	Erlauben Sie dem Benutzer nicht, den Zielzertifikatspeicher zu ändern, der durch den hDestCertStore-Parameter dargestellt wird.
CRYPTUI_WIZ_IMPORT_TO_LOCALMACHINE 0x00100000	Importieren Sie das Objekt in den Zertifikatspeicher für den lokalen Computer. Dies gilt nur für PFX-Importe (Personal Information Exchange).
CRYPTUI_WIZ_IMPORT_TO_CURRENTUSER 0x00200000	Importieren Sie das Objekt in den Zertifikatspeicher für den aktuellen Benutzer. Dies gilt nur für PFX-Importe.
CRYPTUI_WIZ_IMPORT_REMOTE_DEST_STORE 0x00400000	Importieren Sie das Objekt in einen Remotezertifikatspeicher. Legen Sie dieses Flag fest, wenn der hDestCertStore-Parameter einen Remotezertifikatspeicher darstellt.

[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 CRYPTUI_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 CRYPTUI_WIZ_NO_UI-Flag in dwFlags festgelegt ist.

[in] pImportSrc

Ein Zeiger auf eine CRYPTUI_WIZ_IMPORT_SRC_INFO-Struktur , die Informationen zum zu importierenden Objekt enthält. Dieser Parameter ist erforderlich, wenn CRYPTUI_WIZ_NO_UI in dwFlags festgelegt ist und andernfalls optional ist.

[in] hDestCertStore

Ein Handle für den Zertifikatspeicher, in den importiert werden soll. Wenn dieser Parameter NULL ist und das CRYPTUI_WIZ_NO_UI-Flag in dwFlags nicht festgelegt ist, fordert der Assistent den Benutzer auf, einen Zertifikatspeicher auszuwählen.

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.

Hinweise

Wenn keines der folgenden drei Flags in dwFlags festgelegt ist, ist der Import eines beliebigen Inhaltstyps zulässig:

CRYPTUI_WIZ_IMPORT_ALLOW_CERT
CRYPTUI_WIZ_IMPORT_ALLOW_CRL
CRYPTUI_WIZ_IMPORT_ALLOW_CTL

Die flags CRYPTUI_WIZ_IMPORT_TO_LOCALMACHINE und CRYPTUI_WIZ_IMPORT_TO_CURRENTUSER werden verwendet, um den Inhalt eines PFX-BLOBs in den lokalen Computerspeicher oder den aktuellen Benutzerspeicher zu erzwingen. Wenn keines dieser Flags festgelegt ist und hDestCertStoreNULL ist:

Der private Schlüssel im PFX-BLOB muss in den aktuellen Benutzerspeicher importiert werden.
Wenn CRYPTUI_WIZ_NO_UI nicht festgelegt ist, fordert der Assistent den Benutzer auf, einen Zertifikatspeicher aus den aktuellen Benutzerzertifikatspeichern auszuwählen.

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_IMPORT_SRC_INFO

CryptUIWizExport

Freigeben über