NCryptOpenStorageProvider, fonction (ncrypt.h)

  • Article

La fonction NCryptOpenStorageProvider charge et initialise un fournisseur de stockage de clés CNG.

Syntaxe

SECURITY_STATUS NCryptOpenStorageProvider(
  [out]          NCRYPT_PROV_HANDLE *phProvider,
  [in, optional] LPCWSTR            pszProviderName,
  [in]           DWORD              dwFlags
);

Paramètres

[out] phProvider

Pointeur vers une variable NCRYPT_PROV_HANDLE qui reçoit le handle du fournisseur. Une fois que vous avez terminé d’utiliser ce handle, relâchez-le en le transmettant à la fonction NCryptFreeObject .

[in, optional] pszProviderName

Pointeur vers une chaîne Unicode terminée par un caractère Null qui identifie le fournisseur de stockage de clés à charger. Il s’agit de l’alias inscrit du fournisseur de stockage de clés. Ce paramètre est facultatif et peut être NULL. Si ce paramètre a la valeur NULL, le fournisseur de stockage de clés par défaut est chargé. Les valeurs suivantes identifient les fournisseurs de stockage de clés intégrés.

Valeur Signification
MS_KEY_STORAGE_PROVIDER
L"Fournisseur de stockage de clés logicielles Microsoft »
 Identifie le fournisseur de stockage de clés logicielles fourni par Microsoft.
MS_SMART_CARD_KEY_STORAGE_PROVIDER
L"Fournisseur de stockage de clés de carte à puce Microsoft »
 Identifie le fournisseur de stockage de clés smart carte fourni par Microsoft.
MS_PLATFORM_CRYPTO_PROVIDER
L"Microsoft Platform Crypto Provider »
 Identifie le fournisseur de stockage de clés TPM fourni par Microsoft.

[in] dwFlags

Indicateurs qui modifient le comportement de la fonction. Aucun indicateur n’est défini pour cette fonction.

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 un ou plusieurs indicateurs qui ne sont pas pris en charge.
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

Si une condition d’erreur est retournée, le fournisseur a été déchargé de la mémoire. Les fonctions au sein du fournisseur ne doivent pas être appelées après le retour d’une erreur d’échec.

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