Função SslOpenProvider

A função SslOpenProvider abre um identificador para o provedor de protocolo SSL especificado.

Sintaxe

SECURITY_STATUS WINAPI SslOpenProvider(
  _Out_ NCRYPT_PROV_HANDLE *phSslProvider,
  _In_  LPCWSTR            pszProviderName,
  _In_  DWORD              dwFlags
);

Parâmetros

phSslProvider [out]

O endereço de um NCRYPT_PROV_HANDLE no qual gravar o identificador do provedor.

Quando terminar de usar o identificador, você deverá liberá-lo chamando a função SslFreeObject .

pszProviderName [in]

Um ponteiro para uma cadeia de caracteres Unicode que contém o nome do provedor. Se o valor desse parâmetro for NULL, um identificador para o MS_SCHANNEL_PROVIDER será retornado.

dwFlags [in]

Esse parâmetro é reservado para uso futuro e deve ser definido como zero.

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.

Código/valor de retorno	Descrição
NTE_INVALID_HANDLE 0x80090026L	Um dos identificadores fornecidos não é válido.
NTE_INVALID_PARAMETER 0x80090027L	O parâmetro phSslProvider ou ppProviderList é NULL.
STATUS_NO_MEMORY 0xC0000017L	Não há memória suficiente disponível para alocar os buffers necessários.

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