CryptSetProviderA, fonction (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 CryptSetProvider spécifie le fournisseur de services de chiffrement par défaut de l’utilisateur actuel.

Si le fournisseur par défaut d’un utilisateur actuel est défini, ce fournisseur par défaut est acquis par n’importe quel appel de cet utilisateur à CryptAcquireContext en spécifiant un type de fournisseur dwProvType , mais pas un nom CSP.

Une version améliorée de cette fonction, CryptSetProviderEx, est également disponible.

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

Syntaxe

BOOL CryptSetProviderA(
  [in] LPCSTR pszProvName,
  [in] DWORD  dwProvType
);

Paramètres

[in] pszProvName

Nom du nouveau csp par défaut. Le fournisseur csp nommé doit être 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.

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. Certains codes d’erreur possibles sont répertoriés dans le tableau suivant.

Code de retour	Description
ERROR_INVALID_HANDLE	L’un des paramètres spécifie un handle qui n’est pas valide.
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	Le système d’exploitation a manqué de mémoire pendant l’opération.

Les erreurs peuvent également être propagées à partir d’appels internes à RegCreateKeyEx et RegSetValueEx.

Remarques

Les applications classiques ne spécifient pas de nom CSP lors de l’appel de CryptAcquireContext ; Toutefois, une application a la possibilité de sélectionner un fournisseur de solutions Cloud spécifique. Cela donne à l’utilisateur la liberté de sélectionner un fournisseur de solutions Cloud avec un niveau de sécurité approprié.

Étant donné que l’appel de CryptSetProvider détermine le fournisseur de solutions cloud d’un type spécifié utilisé par toutes les applications qui s’exécutent à partir de ce point, cette fonction ne doit pas être appelée sans le consentement des utilisateurs.

Notes

L’en-tête wincrypt.h définit CryptSetProvider comme 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

Noms des fournisseurs de chiffrement

RegCreateKeyEx

RegSetValueEx

Fonctions du fournisseur de services

Partager via