Fonction CryptUIWizImport (cryptuiapi.h)

  • Article

La fonction importe un certificat, une liste d’approbation de certificats (CTL), une liste de révocation de certificats (CRL) ou un magasin de certificats dans un magasin de certificats. L’importation peut être effectuée avec ou sans interaction de l’utilisateur.

Syntaxe

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

Paramètres

[in] dwFlags

Contient des indicateurs qui modifient le comportement de la fonction. Il peut s’agir de zéro ou d’une combinaison d’une ou plusieurs des valeurs suivantes.

Note À l’exception de CRYPTUI_WIZ_NO_UI, aucune des constantes suivantes n’est définie dans un fichier d’en-tête publié. Pour utiliser ces constantes, vous devez les définir à l’aide des valeurs spécifiées.
 
Valeur Signification
CRYPTUI_WIZ_NO_UI
0x0001
 Cette fonction effectue l’importation en fonction des informations de la structure CRYPTUI_WIZ_IMPORT_SRC_INFO pointée par pImportSrc dans le magasin spécifié par hDestCertStore sans afficher d’interface utilisateur. Si cet indicateur n’est pas spécifié, cette fonction affiche un Assistant pour guider l’utilisateur tout au long du processus d’importation.

À compter de Windows 8 et Windows Server 2012, si vous définissez cet indicateur et importez un certificat à partir d’un objet BLOB PFX qui a été protégé vers un principal Active Directory (AD) et que l’utilisateur actuel, dans le cadre de ce principal, est autorisé à déchiffrer le mot de passe incorporé dans le paquet PFX, l’importation réussit sans qu’un mot de passe soit défini dans le CRYPTUI_WIZ_IMPORT_SRC_INFO Structure. Pour plus d’informations sur la protection de PFX sur un principal AD, consultez le paramètre pvPara et l’indicateur PKCS12_PROTECT_TO_DOMAIN_SIDS de la fonction PFXExportCertStoreEx .
CRYPTUI_WIZ_IGNORE_NO_UI_FLAG_FOR_CSPS
0x0002
 Supprimez toutes les interfaces utilisateur générées par les fournisseurs de services de chiffrement (CSP). Cette option peut être remplacée par l’option CRYPTUI_WIZ_NO_UI_EXCEPT_CSP .
CRYPTUI_WIZ_NO_UI_EXCEPT_CSP
0x0003
 Supprimez toutes les interfaces utilisateur à l’exception de celles générées par les fournisseurs de solutions cloud. Cette option remplace l’option CRYPTUI_WIZ_IGNORE_NO_UI_FLAG_FOR_CSPS .
CRYPTUI_WIZ_IMPORT_ALLOW_CERT
0x00020000
 Autoriser l’importation de certificats.
CRYPTUI_WIZ_IMPORT_ALLOW_CRL
0x00040000
 Autoriser l’importation de listes de révocation de certificats.
CRYPTUI_WIZ_IMPORT_ALLOW_CTL
0x00080000
 Autoriser l’importation de CTL.
CRYPTUI_WIZ_IMPORT_NO_CHANGE_DEST_STORE
0x00010000
 N’autorisez pas l’utilisateur à modifier le magasin de certificats de destination représenté par le paramètre hDestCertStore .
CRYPTUI_WIZ_IMPORT_TO_LOCALMACHINE
0x00100000
 Importez l’objet dans le magasin de certificats de l’ordinateur local. Cela s’applique uniquement aux importations d’échange d’informations personnelles (PFX).
CRYPTUI_WIZ_IMPORT_TO_CURRENTUSER
0x00200000
 Importez l’objet dans le magasin de certificats de l’utilisateur actuel. Cela s’applique uniquement aux importations PFX.
CRYPTUI_WIZ_IMPORT_REMOTE_DEST_STORE
0x00400000
 Importez l’objet dans un magasin de certificats distant. Définissez cet indicateur si le paramètre hDestCertStore représente un magasin de certificats distant.

[in] hwndParent

Handle de la fenêtre à utiliser comme parent de la boîte de dialogue créée par cette fonction. Ce paramètre est ignoré si l’indicateur CRYPTUI_WIZ_NO_UI est défini dans dwFlags.

[in] pwszWizardTitle

Pointeur vers une chaîne Unicode terminée par un caractère Null qui contient le titre à utiliser dans la boîte de dialogue créée par cette fonction. Ce paramètre est ignoré si l’indicateur CRYPTUI_WIZ_NO_UI est défini dans dwFlags.

[in] pImportSrc

Pointeur vers une structure CRYPTUI_WIZ_IMPORT_SRC_INFO qui contient des informations sur l’objet à importer. Ce paramètre est obligatoire si CRYPTUI_WIZ_NO_UI est défini dans dwFlags et est facultatif dans le cas contraire.

[in] hDestCertStore

Handle du magasin de certificats dans lequel importer. Si ce paramètre a la valeur NULL et que l’indicateur CRYPTUI_WIZ_NO_UI n’est pas défini dans dwFlags, l’Assistant invite l’utilisateur à sélectionner un magasin de certificats.

Valeur retournée

Si la fonction réussit, la fonction retourne une valeur différente de zéro.

Si la fonction échoue, elle retourne zéro. Pour obtenir des informations d’erreur étendues, appelez la fonction GetLastError .

Remarques

Si aucun des trois indicateurs suivants n’est défini dans dwFlags, l’importation de tout type de contenu est autorisée :

  • CRYPTUI_WIZ_IMPORT_ALLOW_CERT
  • CRYPTUI_WIZ_IMPORT_ALLOW_CRL
  • CRYPTUI_WIZ_IMPORT_ALLOW_CTL
Les indicateurs CRYPTUI_WIZ_IMPORT_TO_LOCALMACHINE et CRYPTUI_WIZ_IMPORT_TO_CURRENTUSER sont utilisés pour forcer le contenu d’un objet BLOB PFX dans le magasin d’ordinateurs locaux ou le magasin d’utilisateurs actuel. Si aucun de ces indicateurs n’est défini et que hDestCertStore a la valeur NULL :
  • La clé privée dans l’objet BLOB PFX sera forcée d’être importée dans le magasin d’utilisateurs actuel.
  • Et si CRYPTUI_WIZ_NO_UI n’est pas défini, l’Assistant invite l’utilisateur à sélectionner un magasin de certificats parmi les magasins de certificats utilisateur actuels.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête cryptuiapi.h
Bibliothèque Cryptui.lib
DLL Cryptui.dll

Voir aussi

CRYPTUI_WIZ_IMPORT_SRC_INFO

CryptUIWizExport