Función SslOpenProvider

  • Artículo

La función SslOpenProvider abre un identificador para el proveedor de protocolo Secure Sockets Layer (SSL) especificado.

Sintaxis

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

Parámetros

phSslProvider [out]

Dirección de un NCRYPT_PROV_HANDLE en el que se va a escribir el identificador del proveedor.

Cuando haya terminado de usar el identificador, debe liberarlo llamando a la función SslFreeObject .

pszProviderName [in]

Puntero a una cadena Unicode que contiene el nombre del proveedor. Si el valor de este parámetro es NULL, se devuelve un identificador para el MS_SCHANNEL_PROVIDER .

dwFlags [in]

Este parámetro está reservado para uso futuro y debe establecerse en cero.

Valor devuelto

Si la función se ejecuta correctamente, devuelve cero.

Si se produce un error en la función, devuelve un valor de error distinto de cero.

Entre los códigos de retorno posibles se incluyen, entre otros, los siguientes.

Código o valor devuelto Descripción
NTE_INVALID_HANDLE
0x80090026L
 Uno de los identificadores proporcionados no es válido.
NTE_INVALID_PARAMETER
0x80090027L
 El parámetro phSslProvider o ppProviderList es NULL.
STATUS_NO_MEMORY
0xC0000017L
 No hay suficiente memoria disponible para asignar los búferes necesarios.

Requisitos

Requisito Value
Cliente mínimo compatible
 Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible
 Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado
Sslprovider.h
Archivo DLL
Ncrypt.dll