CRYPTUI_WIZ_IMPORT_SRC_INFO structure (cryptuiapi.h)

[La structure CRYPTUI_WIZ_IMPORT_SRC_INFO peut être utilisée dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il peut être modifié ou indisponible dans les versions suivantes.]

La structure CRYPTUI_WIZ_IMPORT_SRC_INFO contient l’objet à importer dans la fonction CryptUIWizImport . L’objet peut être un certificat, une liste d’approbation de certificats (CTL) ou une liste de révocation de certificats (CRL).

Syntaxe

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;

Membres

dwSize

Taille, en octets, de cette structure.

dwSubjectChoice

Indique le type de sujet à importer. Ce membre peut être l’une des valeurs suivantes.

Valeur Signification
CRYPTUI_WIZ_IMPORT_SUBJECT_FILE
Importez le certificat stocké dans le fichier référencé dans le membre pwszFileName .
CRYPTUI_WIZ_IMPORT_SUBJECT_CERT_CONTEXT
Importez le certificat référencé dans le membre pCertContext .
CRYPTUI_WIZ_IMPORT_SUBJECT_CTL_CONTEXT
Importez la CTL référencée dans le membre pCTLContext .
CRYPTUI_WIZ_IMPORT_SUBJECT_CRL_CONTEXT
Importez la liste de révocation de certificats référencée dans le membre pCRLContext .
CRYPTUI_WIZ_IMPORT_SUBJECT_CERT_STORE
Importez le magasin de certificats référencé dans le membre hCertStore .

pwszFileName

Pointeur vers une chaîne Unicode terminée par un caractère Null qui contient le chemin d’accès et le nom de fichier du fichier qui contient le certificat à importer. Ce membre est utilisé si le membre dwSubjectChoice contient CRYPTUI_WIZ_IMPORT_SUBJECT_FILE.

pCertContext

Pointeur vers la structure CERT_CONTEXT qui contient le certificat à importer. Ce membre est utilisé si le membre dwSubjectChoice contient CRYPTUI_WIZ_IMPORT_SUBJECT_CERT_CONTEXT.

pCTLContext

Pointeur vers la structure CTL_CONTEXT qui contient la CTL à importer. Ce membre est utilisé si le membre dwSubjectChoice contient CRYPTUI_WIZ_IMPORT_SUBJECT_CTL_CONTEXT.

pCRLContext

Pointeur vers la structure CRL_CONTEXT qui contient la liste de révocation de certificats à importer. Ce membre est utilisé si le membre dwSubjectChoice contient CRYPTUI_WIZ_IMPORT_SUBJECT_CRL_CONTEXT.

hCertStore

Handle pour le magasin de certificats à importer. Ce membre est utilisé si le membre dwSubjectChoice contient CRYPTUI_WIZ_IMPORT_SUBJECT_CERT_STORE.

dwFlags

Contient des indicateurs qui modifient l’opération d’importation. Ce membre est obligatoire si pwszFileName contient un objet BLOB PFX (Personal Information Exchange). Sinon, ce membre est ignoré. Ce membre peut être égal à zéro ou à une combinaison d’une ou plusieurs des valeurs suivantes.

Valeur Signification
CRYPT_EXPORTABLE
Les clés importées sont marquées comme étant exportables. Si cet indicateur n’est pas utilisé, les appels à la fonction CryptExportKey avec le handle de clé échouent.
CRYPT_USER_PROTECTED
L’utilisateur doit être averti par le biais d’une boîte de dialogue ou d’une autre manière lorsque certaines actions tentent d’utiliser cette clé. Le comportement précis est spécifié par le fournisseur de services de chiffrement (CSP) utilisé.

Avant Internet Explorer 4.0, les fournisseurs de services cloud Microsoft ignoraient cet indicateur. À compter d’Internet Explorer 4.0, les fournisseurs de services cloud Microsoft prennent en charge cet indicateur.

Si le contexte du fournisseur a été ouvert avec l’indicateur CRYPT_SILENT défini, l’utilisation de cet indicateur entraîne un échec et la dernière erreur est définie sur NTE_SILENT_CONTEXT.

CRYPT_MACHINE_KEYSET
Les clés privées sont stockées sous l’ordinateur local et non sous l’utilisateur actuel.
CRYPT_USER_KEYSET
Les clés privées sont stockées sous l’utilisateur actuel et non sous l’ordinateur local, même si l’objet BLOB PFX spécifie qu’elles doivent passer sous l’ordinateur local.

pwszPassword

Pointeur vers une chaîne Unicode terminée par null qui contient le mot de passe utilisé pour accéder à la clé privée. Un mot de passe est requis si pwszFileName contient un objet BLOB PFX. Si aucun mot de passe n’est requis, la variable peut être une chaîne vide. Ce membre ne peut pas être NULL.

Configuration requise

   
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
En-tête cryptuiapi.h

Voir aussi

CRYPTUI_WIZ_EXPORT_INFO

CryptUIWizExport