Fonction NCryptEnumStorageProviders (ncrypt.h)

  • Article

La fonction NCryptEnumStorageProviders obtient les noms des fournisseurs de stockage de clés inscrits.

Syntaxe

SECURITY_STATUS NCryptEnumStorageProviders(
  [out] DWORD              *pdwProviderCount,
  [out] NCryptProviderName **ppProviderList,
  [in]  DWORD              dwFlags
);

Paramètres

[out] pdwProviderCount

Adresse d’un DWORD pour recevoir le nombre d’éléments dans le tableau ppProviderList .

[out] ppProviderList

Adresse d’un pointeur de structure NCryptProviderName pour recevoir un tableau des noms de fournisseur de stockage de clés inscrites. La variable pointée vers par le paramètre pdwProviderCount reçoit le nombre d’éléments dans ce tableau.

Lorsque cette mémoire n’est plus nécessaire, libérez-la en passant ce pointeur vers la fonction NCryptFreeBuffer .

[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 de clé (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
 La fonction a réussi.
NTE_BAD_FLAGS
 Le paramètre dwFlags contient une valeur qui n’est pas valide.
NTE_INVALID_PARAMETER
 Un ou plusieurs paramètres ne sont pas valides.
NTE_NO_MEMORY
 Un échec d’allocation de mémoire s’est produit.

Remarques

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 blocage 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 uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête ncrypt.h
Bibliothèque Ncrypt.lib
DLL Ncrypt.dll

Voir aussi

NCryptFreeBuffer