CryptSetProviderW, fonction (wincrypt.h)

Article
11/20/2024

important cette API est déconseillée. Les logiciels nouveaux et existants doivent commencer à utiliser 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 (CSP).

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 pour 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.

Remarque applications classiques n’utilisent pas cette fonction. Elle est destinée uniquement aux applications administratives.

Syntaxe

BOOL CryptSetProviderW(
  [in] LPCWSTR 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 de fournisseurs de chiffrement.

[in] dwProvType

Type de fournisseur de solutions cloud spécifié par pszProvName.

Valeur de retour

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.

Retourner le code	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 dépassé la mémoire pendant l’opération.

Les erreurs peuvent également être propagées à partir d’appels internes vers 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 csp spécifique. Cela donne à un utilisateur la liberté de sélectionner un fournisseur de solutions Cloud avec un niveau de sécurité approprié.

Étant donné que l’appel 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.

Note

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. Le mélange 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows XP [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	wincrypt.h
bibliothèque	Advapi32.lib
DLL	Advapi32.dll

Voir aussi

CryptAcquireContext

noms de fournisseurs de chiffrement

RegCreateKeyEx

RegSetValueEx

fonctions du fournisseur de services

Partager via