SslGetKeyProperty-Funktion

Die SslGetKeyProperty-Funktion ruft den Wert einer benannten Eigenschaft für ein SSL-Schlü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 beendete Unicode-Zeichenfolge, die den Namen der abzurufenden Eigenschaft enthält. Dies kann einer der vordefinierten Schlüssel-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 frei geben.

–output [ 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 0 (null) zurück.

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

Mögliche Rückgabecodes sind u. a. folgende:

Rückgabecode/-wert Beschreibung
NTE _ UNGÜLTIGES _ HANDLE
0x80090026L
Eines der bereitgestellten Handles ist ungültig.
NTE _ UNGÜLTIGER _ PARAMETER
0x80090027L
Einer der angegebenen Parameter ist ungültig.

Anforderungen

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