Compartilhar via

Função SslOpenProvider

  • Artigo

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