Partager via

SslOpenProvider, fonction

  • Article

La fonction SslOpenProvider ouvre un handle au fournisseur de protocole SSL ( Secure Sockets Layer ) spécifié.

Syntaxe

SECURITY_STATUS WINAPI SslOpenProvider(
  _Out_ NCRYPT_PROV_HANDLE *phSslProvider,
  _In_  LPCWSTR            pszProviderName,
  _In_  DWORD              dwFlags
);

Paramètres

phSslProvider [out]

Adresse d’un NCRYPT_PROV_HANDLE dans lequel écrire le handle du fournisseur.

Une fois que vous avez terminé d’utiliser le handle, vous devez le libérer en appelant la fonction SslFreeObject .

pszProviderName [in]

Pointeur vers une chaîne Unicode qui contient le nom du fournisseur. Si la valeur de ce paramètre est NULL, un handle au MS_SCHANNEL_PROVIDER est retourné.

dwFlags [in]

Ce paramètre est réservé pour une utilisation ultérieure et doit être défini sur zéro.

Valeur retournée

Si la fonction réussit, elle retourne zéro.

Si la fonction échoue, elle retourne une valeur d’erreur différente de zéro.

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

Code/valeur de retour Description
NTE_INVALID_HANDLE
0x80090026L
 L’un des handles fournis n’est pas valide.
NTE_INVALID_PARAMETER
0x80090027L
 Le paramètre phSslProvider ou ppProviderList est NULL.
STATUS_NO_MEMORY
0xC0000017L
 La mémoire disponible est insuffisante pour allouer les mémoires tampons nécessaires.

Spécifications

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]
En-tête
Sslprovider.h
DLL
Ncrypt.dll