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 |
|---|---|
|
Eines der bereitgestellten Handles ist ungültig. |
|
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 |
|
| DLL |
|