SslOpenProvider-Funktion
Die SslOpenProvider-Funktion öffnet ein Handle für den angegebenen Secure Sockets Layer Protokollanbieter (SSL).
Syntax
SECURITY_STATUS WINAPI SslOpenProvider(
_Out_ NCRYPT_PROV_HANDLE *phSslProvider,
_In_ LPCWSTR pszProviderName,
_In_ DWORD dwFlags
);
Parameter
-
phSslProvider [ out]
-
Die Adresse eines NCRYPT _ PROV _ HANDLE, in das das Anbieterhand handle geschrieben werden soll.
Wenn Sie das Handle nicht mehr verwenden, sollten Sie es durch Aufrufen der SslFreeObject-Funktion wieder frei geben.
-
pszProviderName [ In]
-
Ein Zeiger auf eine Unicode-Zeichenfolge, die den Anbieternamen enthält. Wenn der Wert dieses Parameters NULL ist, wird ein Handle für den MS _ SCHANNEL _ PROVIDER zurückgegeben.
-
dwFlags [ In]
-
Dieser Parameter ist für die zukünftige Verwendung reserviert und muss auf 0 (null) festgelegt werden.
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. |
|
Der phSslProvider- oder ppProviderList-Parameter ist NULL. |
|
Es ist nicht genügend Arbeitsspeicher verfügbar, um erforderliche Puffer zu reservieren. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Nur [ Vista-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server [ 2008-Desktop-Apps] |
| Header |
|
| DLL |
|