Fonction CryptInstallDefaultContext (wincrypt.h)
Syntaxe
BOOL CryptInstallDefaultContext(
[in] HCRYPTPROV hCryptProv,
[in] DWORD dwDefaultType,
[in] const void *pvDefaultPara,
[in] DWORD dwFlags,
[in] void *pvReserved,
[out] HCRYPTDEFAULTCONTEXT *phDefaultContext
);
Paramètres
[in] hCryptProv
Handle du fournisseur de services de chiffrement à utiliser comme contexte par défaut. Ce handle est obtenu à l’aide de la fonction CryptAcquireContext .
[in] dwDefaultType
Spécifie le type de contexte à installer. Il doit s’agir de l’une des valeurs suivantes.
| Valeur | Signification |
|---|---|
|
Installe le fournisseur par défaut utilisé pour vérifier un type de signature de certificat unique.
Le paramètre pvDefaultPara est l’adresse d’une chaîne ANSI terminée par null qui contient l’identificateur d’objet de l’algorithme de signature de certificat pour installer le fournisseur pour, par exemple, szOID_OIWSEC_md5RSA. Si le paramètre pvDefaultPara a la valeur NULL, le fournisseur spécifié est utilisé pour vérifier toutes les signatures de certificat. Le paramètre pvDefaultPara ne peut pas être NULL lorsque l’indicateur CRYPT_DEFAULT_CONTEXT_PROCESS_FLAG est défini. |
|
Installe le fournisseur par défaut utilisé pour vérifier plusieurs types de signature de certificat.
Le paramètre pvDefaultPara est l’adresse d’une structure de CRYPT_DEFAULT_CONTEXT_MULTI_OID_PARA qui contient un tableau d’identificateurs d’objet qui identifient les algorithmes de signature de certificat pour 2000 pour 1000. |
[in] pvDefaultPara
Spécifie l’objet pour lequel installer le fournisseur de contexte par défaut. Le format de ce paramètre dépend du contenu du paramètre dwDefaultType .
[in] dwFlags
Ensemble d’indicateurs qui modifient le comportement de cette fonction. Il peut s’agir de zéro ou d’une combinaison d’une ou plusieurs des valeurs suivantes.
| Valeur | Signification |
|---|---|
|
Le handle de fournisseur spécifié par le paramètre hCryptProv est automatiquement libéré lorsque le processus ou le thread se termine. Si cet indicateur n’est pas spécifié, il incombe à l’appelant de libérer le handle du fournisseur à l’aide de la fonction CryptReleaseContext lorsque le handle n’est plus nécessaire. Le handle du fournisseur n’est pas libéré si la fonction CryptUninstallDefaultContext est appelée avant la fermeture du processus ou du thread. |
|
Le fournisseur s’applique à tous les threads du processus. Si cet indicateur n’est pas spécifié, le fournisseur s’applique uniquement au thread appelant. Le paramètre pvDefaultPara ne peut pas être NULL lorsque cet indicateur est défini. |
[in] pvReserved
Ce paramètre est réservé à un usage futur.
[out] phDefaultContext
Adresse d’une variable HCRYPTDEFAULTCONTEXT qui reçoit le handle de contexte par défaut. Ce handle est passé à la fonction CryptUninstallDefaultContext pour désinstaller le fournisseur de contexte par défaut.
Valeur retournée
Si la fonction réussit, la valeur de retour est différente de zéro (TRUE). Si la fonction échoue, la valeur de retour est zéro (FALSE). Pour obtenir des informations d’erreur étendues, appelez GetLastError.
Remarques
Les fournisseurs de contexte par défaut installés sont classés par pile. Par conséquent, lors de la recherche d’un fournisseur de contexte par défaut, le système commence par le fournisseur le plus récemment installé. La liste des fournisseurs par thread est recherchée avant la liste des fournisseurs par processus. Une fois qu’une correspondance est trouvée, le système ne continue pas à rechercher d’autres correspondances.
Le handle du fournisseur installé doit rester disponible jusqu’à ce que CryptUninstallDefaultContext soit appelé ou que le thread ou le processus se termine.
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 | wincrypt.h |
| Bibliothèque | Crypt32.lib |
| DLL | Crypt32.dll |