Partager via


SslGetProviderProperty, fonction

La fonction SslGetProviderProperty récupère la valeur d’une propriété de fournisseur spécifiée.

Syntaxe

SECURITY_STATUS WINAPI SslGetProviderProperty(
  _In_    NCRYPT_PROV_HANDLE hSslProvider,
  _In_    LPCWSTR            pszProperty,
  _Out_   PBYTE              ppbOutput,
  _Out_   DWORD              *pcbOutput,
  _Inout_ PVOID              *ppEnumState,
  _In_    DWORD              dwFlags
);

Paramètres

hSslProvider [in]

Handle du fournisseur SSL ( Secure Sockets Layer ) pour lequel récupérer la propriété.

pszProperty [in]

Pointeur vers une chaîne Unicode terminée par null qui contient le nom de la propriété à récupérer.

ppbOutput [out]

Adresse d’une mémoire tampon qui reçoit la valeur de la propriété.

L’appelant de la fonction doit libérer cette mémoire tampon en appelant la fonction SslFreeBuffer .

ccpOutput [out]

Taille, en octets, de la mémoire tampon pbOutput .

ppEnumState [in, out]

Adresse d’un pointeur VOID qui reçoit des informations d’état d’énumération utilisées dans les appels suivants à cette fonction. Ces informations ont uniquement une signification pour le fournisseur SSL et sont opaques pour l’appelant. Le fournisseur SSL utilise ces informations pour déterminer l’élément suivant dans l’énumération. Si la variable pointée par ce paramètre contient NULL, l’énumération est démarrée à partir du début.

L’appelant de la fonction doit libérer cette mémoire en appelant la fonction SslFreeBuffer .

dwFlags [in]

Ce paramètre est réservé à un usage futur.

Valeur retournée

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

Si la fonction échoue, elle retourne une valeur d’erreur non nulle.

Les codes de retour possibles incluent, mais ne sont pas limités à, les éléments suivants.

Code/valeur de retour Description
NTE_NO_MEMORY
0x8009000EL
La mémoire n’est pas suffisante pour allouer les mémoires tampons nécessaires.
NTE_INVALID_HANDLE
0x80090026L
Le handle hSslProvider n’est pas valide.
NTE_INVALID_PARAMETER
0x80090027L
L’un des paramètres fournis n’est pas valide.

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