NCryptIsAlgSupported, fonction (ncrypt.h)

Article
08/25/2023

La fonction NCryptIsAlgSupported détermine si un fournisseur de stockage de clés CNG prend en charge un algorithme de chiffrement spécifique.

Syntaxe

SECURITY_STATUS NCryptIsAlgSupported(
  [in] NCRYPT_PROV_HANDLE hProvider,
  [in] LPCWSTR            pszAlgId,
  [in] DWORD              dwFlags
);

Paramètres

[in] hProvider

Handle du fournisseur de stockage de clés. Ce handle est obtenu avec la fonction NCryptOpenStorageProvider .

[in] pszAlgId

Pointeur vers une chaîne Unicode terminée par null qui identifie l’algorithme de chiffrement en question. Il peut s’agir de l’un des identificateurs d’algorithme CNG standard ou de l’identificateur d’un autre algorithme inscrit.

[in] dwFlags

Indicateurs qui modifient le comportement de la fonction. Il peut s’agir de zéro (0) ou de la valeur suivante.

Valeur	Signification
NCRYPT_SILENT_FLAG	Demande que le fournisseur de services clés (KSP) n’affiche aucune interface utilisateur. Si le fournisseur doit afficher l’interface utilisateur pour fonctionner, l’appel échoue et le KSP doit définir le code d’erreur NTE_SILENT_CONTEXT comme dernière erreur.

Valeur retournée

Retourne un code status qui indique la réussite ou l’échec de la fonction.

Les codes de retour possibles incluent, sans s’y limiter, les éléments suivants.

Code de retour	Description
ERROR_SUCCESS	Le fournisseur prend en charge l’algorithme spécifié.
NTE_BAD_FLAGS	Le paramètre dwFlags contient un ou plusieurs indicateurs qui ne sont pas pris en charge.
NTE_INVALID_HANDLE	Le handle spécifié par le paramètre hProvider n’est pas valide.
NTE_INVALID_PARAMETER	Un ou plusieurs paramètres ne sont pas valides.
NTE_NOT_SUPPORTED	Le fournisseur ne prend pas en charge l’algorithme spécifié.

Remarques

Si le fournisseur prend en charge l’algorithme, cette fonction retourne ERROR_SUCCESS. Si le fournisseur ne prend pas en charge l’algorithme et qu’aucune autre erreur ne s’est produite, cette fonction retourne NTE_NOT_SUPPORTED.

Un service ne doit pas appeler cette fonction à partir de sa fonction StartService. Si un service appelle cette fonction à partir de sa fonction StartService, un interblocage peut se produire et le service peut cesser de répondre.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	ncrypt.h
Bibliothèque	Ncrypt.lib
DLL	Ncrypt.dll

Partager via