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
NTE _ UNGÜLTIGES _ HANDLE
0x80090026L
Eines der bereitgestellten Handles ist ungültig.
NTE _ UNGÜLTIGER _ PARAMETER
0x80090027L
Der phSslProvider- oder ppProviderList-Parameter ist NULL.
STATUS _ NO _ MEMORY
0xC0000017L
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
Sslprovider.h
DLL
Ncrypt.dll