Partilhar via


Função SslEnumProtocolProviders

A função SslEnumProtocolProviders retorna uma matriz de provedores de protocolo SSL ( protocolo SSL) instalados.

Sintaxe

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

Parâmetros

pdwProviderCount [out]

Um ponteiro para um valor DWORD para receber o número de provedores de protocolo retornados.

ppProviderList [out]

Um ponteiro para um buffer que recebe a matriz de estruturas NCryptProviderName .

dwFlags [in]

Esse parâmetro é reservado para uso futuro.

Valor retornado

Se a função for bem-sucedida, ela retornará zero.

Se a função falhar, ela retornará um valor de erro diferente de zero.

Os códigos de retorno possíveis incluem, mas não se limitam a, o seguinte.

Retornar código/valor Descrição
NTE_BAD_FLAGS
0x80090009L
O parâmetro dwFlags não é zero.
NTE_NO_MEMORY
0x8009000EL
Não há memória suficiente disponível para alocar buffers necessários.
NTE_INVALID_PARAMETER
0x80090027L
O parâmetro pdwProviderCount ou ppProviderList é NULL.

Comentários

Quando terminar de usar a matriz de estruturas NCryptProviderName , chame a função SslFreeBuffer para liberar a matriz.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho
Sslprovider.h
DLL
Ncrypt.dll