SslOpenProvider-Funktion

Die SslOpenProvider-Funktion öffnet ein Handle für den angegebenen SSL-Protokollanbieter ( Secure Sockets Layer Protocol ).

Syntax

SECURITY_STATUS WINAPI SslOpenProvider(
  _Out_ NCRYPT_PROV_HANDLE *phSslProvider,
  _In_  LPCWSTR            pszProviderName,
  _In_  DWORD              dwFlags
);

Parameter

phSslProvider [out]

Die Adresse einer NCRYPT_PROV_HANDLE , in die das Anbieterhandle geschrieben werden soll.

Wenn Sie die Verwendung des Handles abgeschlossen haben, sollten Sie es freigeben, indem Sie die SslFreeObject-Funktion aufrufen.

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 die 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 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
NTE_INVALID_HANDLE 0x80090026L	Einer der bereitgestellten Handles ist ungültig.
NTE_INVALID_PARAMETER 0x80090027L	Der Parameter phSslProvider oder ppProviderList ist NULL.
STATUS_NO_MEMORY 0xC0000017L	Es ist nicht genügend Arbeitsspeicher verfügbar, um die erforderlichen Puffer zuzuweisen.

Anforderungen

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