Partager via


Fonction CryptSetProviderExA (wincrypt.h)

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