Fonction CryptSetProviderExA (wincrypt.h)

Article
08/27/2023

Important Cette API est déconseillée. Les logiciels nouveaux et existants doivent commencer à utiliser les API de nouvelle génération de chiffrement. Microsoft peut supprimer cette API dans les versions ultérieures.

La fonction CryptSetProviderEx spécifie le fournisseur de services de chiffrement (CSP) par défaut d’un type de fournisseur spécifié pour l’ordinateur local ou l’utilisateur actuel.

Note Les applications classiques n’utilisent pas cette fonction. Il est destiné à être utilisé uniquement par les applications administratives.

Syntaxe

BOOL CryptSetProviderExA(
  [in] LPCSTR pszProvName,
  [in] DWORD  dwProvType,
  [in] DWORD  *pdwReserved,
  [in] DWORD  dwFlags
);

Paramètres

[in] pszProvName

Nom du nouveau fournisseur de solutions Cloud par défaut. Il doit s’agir d’un fournisseur de solutions Cloud installé sur l’ordinateur. Pour obtenir la liste des fournisseurs de chiffrement disponibles, consultez Noms des fournisseurs de chiffrement.

[in] dwProvType

Type de fournisseur du fournisseur csp spécifié par pszProvName.

[in] pdwReserved

Ce paramètre est réservé pour une utilisation ultérieure et doit être NULL.

[in] dwFlags

Les valeurs d’indicateur suivantes sont définies.

Valeur	Signification
CRYPT_DELETE_DEFAULT 0x00000004	Peut être utilisé conjointement avec CRYPT_MACHINE_DEFAULT ou CRYPT_USER_DEFAULT pour supprimer la valeur par défaut.
CRYPT_USER_DEFAULT 0x00000002	Entraîne la définition du fournisseur de services de configuration par défaut de contexte utilisateur du type spécifié.
CRYPT_MACHINE_DEFAULT 0x00000001	Entraîne la définition du fournisseur de services de configuration par défaut de l’ordinateur du type spécifié.

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. Les codes d’erreur possibles incluent ceux indiqués dans le tableau suivant.

Code de retour	Description
ERROR_INVALID_PARAMETER	L’un des paramètres contient une valeur qui n’est pas valide. Il s’agit le plus souvent d’un pointeur qui n’est pas valide.
ERROR_NOT_ENOUGH_MEMORY	La mémoire du système d’exploitation est insuffisante.

Remarques

La plupart des applications ne spécifient pas de nom CSP lors de l’appel de la fonction CryptAcquireContext ; Toutefois, une application peut spécifier un nom CSP et ainsi sélectionner un fournisseur de solutions cloud avec un niveau de sécurité approprié. Étant donné que les appels à CryptSetProviderEx déterminent le csp d’un type spécifié utilisé par toutes les applications à partir de ce point, CryptSetProviderEx ne doit jamais être appelé sans le consentement d’un utilisateur.

Notes

L’en-tête wincrypt.h définit CryptSetProviderEx en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

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]
Plateforme cible	Windows
En-tête	wincrypt.h
Bibliothèque	Advapi32.lib
DLL	Advapi32.dll

Voir aussi

CryptAcquireContext

CryptSetProvider

Fonctions du fournisseur de services

Partager via