SslEnumProtocolProviders-Funktion

Die SslEnumProtocolProviders-Funktion gibt ein Array von installierten Secure Sockets Layer-Protokollanbietern (SSL) 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 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 _ BAD _ FLAGS
0x80090009L
Der dwFlags-Parameter ist nicht 0 (null).
NTE _ NO _ MEMORY
0x8009000EL
Es ist nicht genügend Arbeitsspeicher verfügbar, um erforderliche Puffer zu reservieren.
NTE _ UNGÜLTIGER _ PARAMETER
0x80090027L
Der pdwProviderCount- oder ppProviderList-Parameter ist NULL.

Bemerkungen

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

Requirements (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