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