SslEnumProtocolProviders function

The SslEnumProtocolProviders function returns an array of installed Secure Sockets Layer protocol (SSL) protocol providers.

Syntax

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

Parameters

pdwProviderCount [out]

A pointer to a DWORD value to receive the number of protocol providers returned.

ppProviderList [out]

A pointer to a buffer that receives the array of NCryptProviderName structures.

dwFlags [in]

This parameter is reserved for future use.

Return value

If the function succeeds, it returns zero.

If the function fails, it returns a nonzero error value.

Possible return codes include, but are not limited to, the following.

Return code/value Description
NTE_BAD_FLAGS
0x80090009L
The dwFlags parameter is not zero.
NTE_NO_MEMORY
0x8009000EL
Not enough memory is available to allocate necessary buffers.
NTE_INVALID_PARAMETER
0x80090027L
The pdwProviderCount or ppProviderList parameter is NULL.

Remarks

When you have finished using the array of NCryptProviderName structures, call the SslFreeBuffer function to free the array.

Requirements

Requirement Value
Minimum supported client
Windows Vista [desktop apps only]
Minimum supported server
Windows Server 2008 [desktop apps only]
Header
Sslprovider.h
DLL
Ncrypt.dll