SslEnumProtocolProviders-Funktion

Artikel
06/12/2023

Die SslEnumProtocolProviders-Funktion gibt ein Array installierter SSL-Protokollanbieter ( Secure Sockets Layer Protocol ) zurück.

Syntax

SECURITY_STATUS WINAPI SslEnumProtocolProviders(
  _Out_ DWORD              *pdwProviderCount,
  _Out_ NCryptProviderName **ppProviderList,
  _In_  DWORD              dwFlags
);

Parameter

pdwProviderCount [out]: Ein Zeiger auf einen DWORD-Wert , um die Anzahl der zurückgegebenen Protokollanbieter zu empfangen.
ppProviderList [out]: Ein Zeiger auf einen Puffer, der das Array von NCryptProviderName-Strukturen empfängt.
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, gibt sie einen fehlerfreien Wert zurück.

Mögliche Rückgabecodes umfassen folgendes, sind aber nicht darauf beschränkt.

Rückgabecode/-wert	Beschreibung
NTE_BAD_FLAGS 0x80090009L	Der dwFlags-Parameter ist nicht 0.
NTE_NO_MEMORY 0x8009000EL	Für die Zuweisung der erforderlichen Puffer steht nicht genügend Arbeitsspeicher zur Verfügung.
NTE_INVALID_PARAMETER 0x80090027L	Der Parameter pdwProviderCount oder ppProviderList ist NULL.

Bemerkungen

Wenn Sie die Verwendung des Arrays der NCryptProviderName-Strukturen abgeschlossen haben, rufen Sie die SslFreeBuffer-Funktion auf, um das Array zu befreien.

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

Freigeben über