Freigeben über

SslOpenProvider-Funktion

  • Artikel

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