SslGetKeyProperty, fonction

La fonction SslGetKeyProperty récupère la valeur d’une propriété nommée pour un objet de clé de fournisseur SSL ( Secure Sockets Layer Protocol ).

Syntaxe

SECURITY_STATUS WINAPI SslGetKeyProperty(
  _In_  NCRYPT_KEY_HANDLE hKey,
  _In_  LPCWSTR           pszProperty,
  _Out_ PBYTE             ppbOutput,
  _Out_ DWORD             *pcbOutput,
  _In_  DWORD             dwFlags
);

Paramètres

hKey [in]

Handle du fournisseur SSL.

pszProperty [in]

Pointeur vers une chaîne Unicode terminée par null qui contient le nom de la propriété à récupérer. Il peut s’agir de l’une des clés prédéfinies Stockage identificateurs de propriété ou d’un identificateur de propriété personnalisé.

ppbOutput [out]

Pointeur vers 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 .

pcbOutput [out]

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

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 différente de zéro.

Les codes de retour possibles incluent, mais ne sont pas limités, 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	L’un des paramètres fournis n’est pas valide.

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