CRYPTUI_WIZ_IMPORT_SRC_INFO-Struktur (cryptuiapi.h)

Artikel
08/22/2023

[Die CRYPTUI_WIZ_IMPORT_SRC_INFO-Struktur steht für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen zur Verfügung. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]

Die CRYPTUI_WIZ_IMPORT_SRC_INFO-Struktur enthält den Betreff, der in die CryptUIWizImport-Funktion importiert werden soll. Der Antragsteller kann ein Zertifikat, eine Zertifikatvertrauensliste (Certificate Trust List , CTL) oder eine Zertifikatsperrliste (Certificate Revocation List , CRL) sein.

Syntax

typedef struct _CRYPTUI_WIZ_IMPORT_SUBJECT_INFO {
  DWORD   dwSize;
  DWORD   dwSubjectChoice;
  union {
    LPCWSTR        pwszFileName;
    PCCERT_CONTEXT pCertContext;
    PCCTL_CONTEXT  pCTLContext;
    PCCRL_CONTEXT  pCRLContext;
    HCERTSTORE     hCertStore;
  };
  DWORD   dwFlags;
  LPCWSTR pwszPassword;
} CRYPTUI_WIZ_IMPORT_SRC_INFO, *PCRYPTUI_WIZ_IMPORT_SRC_INFO;

Member

dwSize

Die Größe (in Bytes) dieser Struktur.

dwSubjectChoice

Gibt den Typ des zu importierenden Antragstellers an. Dieser Member kann einer der folgenden Werte sein.

Wert	Bedeutung
CRYPTUI_WIZ_IMPORT_SUBJECT_FILE	Importieren Sie das Zertifikat, das in der Datei gespeichert ist, auf die im pwszFileName-Element verwiesen wird.
CRYPTUI_WIZ_IMPORT_SUBJECT_CERT_CONTEXT	Importieren Sie das Zertifikat, auf das im pCertContext-Element verwiesen wird.
CRYPTUI_WIZ_IMPORT_SUBJECT_CTL_CONTEXT	Importieren Sie die CTL, auf die im pCTLContext-Member verwiesen wird.
CRYPTUI_WIZ_IMPORT_SUBJECT_CRL_CONTEXT	Importieren Sie die CRL, auf die im pCRLContext-Member verwiesen wird.
CRYPTUI_WIZ_IMPORT_SUBJECT_CERT_STORE	Importieren Sie den Zertifikatspeicher, auf den im hCertStore-Member verwiesen wird.

pwszFileName

Ein Zeiger auf eine Unicode-Zeichenfolge, die null endet und den Pfad und Dateinamen der Datei enthält, die das zu importierende Zertifikat enthält. Dieses Element wird verwendet, wenn das dwSubjectChoice-ElementCRYPTUI_WIZ_IMPORT_SUBJECT_FILE enthält.

pCertContext

Ein Zeiger auf die CERT_CONTEXT-Struktur , die das zu importierende Zertifikat enthält. Dieser Member wird verwendet, wenn das dwSubjectChoice-ElementCRYPTUI_WIZ_IMPORT_SUBJECT_CERT_CONTEXT enthält.

pCTLContext

Ein Zeiger auf die CTL_CONTEXT-Struktur , die die zu importierende CTL enthält. Dieses Element wird verwendet, wenn das dwSubjectChoice-ElementCRYPTUI_WIZ_IMPORT_SUBJECT_CTL_CONTEXT enthält.

pCRLContext

Ein Zeiger auf die CRL_CONTEXT-Struktur , die die zu importierende Zertifikatsperrliste enthält. Dieser Member wird verwendet, wenn das dwSubjectChoice-ElementCRYPTUI_WIZ_IMPORT_SUBJECT_CRL_CONTEXT enthält.

hCertStore

Ein Handle für den zu importierenden Zertifikatspeicher. Dieser Member wird verwendet, wenn das dwSubjectChoice-ElementCRYPTUI_WIZ_IMPORT_SUBJECT_CERT_STORE enthält.

dwFlags

Enthält Flags, die den Importvorgang ändern. Dieser Member ist erforderlich, wenn pwszFileName ein PFX-BLOB (Personal Information Exchange) enthält. Andernfalls wird dieser Member ignoriert. Dieser Member kann null oder eine Kombination aus einem oder mehreren der folgenden Werte sein.

Wert	Bedeutung
CRYPT_EXPORTABLE	Importierte Schlüssel werden als exportierbar markiert. Wenn dieses Flag nicht verwendet wird, schlagen Aufrufe der CryptExportKey-Funktion mit dem Schlüsselhandle fehl.
CRYPT_USER_PROTECTED	Der Benutzer muss über ein Dialogfeld oder eine andere Weise benachrichtigt werden, wenn bestimmte Aktionen versuchen, diesen Schlüssel zu verwenden. Das genaue Verhalten wird vom verwendeten Kryptografiedienstanbieter (CSP ) angegeben. Vor internet Explorer 4.0 ignorierten Microsoft-CSPs dieses Flag. Ab Internet Explorer 4.0 unterstützen Microsoft CSPs dieses Flag. Wenn der Anbieterkontext mit festgelegtem CRYPT_SILENT-Flag geöffnet wurde, verursacht die Verwendung dieses Flags einen Fehler, und der letzte Fehler wird auf NTE_SILENT_CONTEXT festgelegt.
CRYPT_MACHINE_KEYSET	Die privaten Schlüssel werden auf dem lokalen Computer und nicht unter dem aktuellen Benutzer gespeichert.
CRYPT_USER_KEYSET	Die privaten Schlüssel werden unter dem aktuellen Benutzer und nicht auf dem lokalen Computer gespeichert, auch wenn das PFX-BLOB angibt, dass sie unter den lokalen Computer wechseln sollen.

pwszPassword

Zeiger auf eine Unicode-Zeichenfolge mit Null-Endung, die das Kennwort für den Zugriff auf den privaten Schlüssel enthält. Ein Kennwort ist erforderlich, wenn pwszFileName ein PFX-BLOB enthält. Wenn kein Kennwort erforderlich ist, kann die Variable eine leere Zeichenfolge sein. Dieser Member darf nicht NULL sein.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	cryptuiapi.h

Weitere Informationen

CRYPTUI_WIZ_EXPORT_INFO

CryptUIWizExport

Share via