SslGetKeyProperty-Funktion

Die SslGetKeyProperty-Funktion ruft den Wert einer benannten Eigenschaft für ein SSL-Anbieterschlüsselobjekt ( Secure Sockets Layer Protocol ) ab.

Syntax

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

Parameter

hKey [in]

Das Handle des SSL-Anbieters.

pszProperty [in]

Ein Zeiger auf eine mit NULL endende Unicode-Zeichenfolge, die den Namen der abzurufenden Eigenschaft enthält. Dies kann einer der vordefinierten Key Storage-Eigenschaftsbezeichner oder ein benutzerdefinierter Eigenschaftenbezeichner sein.

ppbOutput [out]

Ein Zeiger auf einen Puffer, der den Eigenschaftswert empfängt. Der Aufrufer der Funktion muss diesen Puffer durch Aufrufen der SslFreeBuffer-Funktion freigeben.

pcbOutput [out]

Die Größe des pbOutput-Puffers in Bytes.

dwFlags [in]

Dieser Parameter ist für die zukünftige Verwendung reserviert.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie null zurück.

Wenn die Funktion fehlschlägt, wird ein Fehlerwert ungleich null zurückgegeben.

Mögliche Rückgabecodes sind u. a. die folgenden:

Rückgabecode/-wert	BESCHREIBUNG
NTE_INVALID_HANDLE 0x80090026L	Einer der bereitgestellten Handles ist ungültig.
NTE_INVALID_PARAMETER 0x80090027L	Einer der angegebenen Parameter ist ungültig.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Header	Sslprovider.h
DLL	Ncrypt.dll