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.
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 |
|---|---|
|
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. |
|
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. |
|
Les clés privées sont stockées sous l’ordinateur local et non sous l’utilisateur actuel. |
|
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 |