Función SslGetProviderProperty

La función SslGetProviderProperty recupera el valor de una propiedad de proveedor especificada.

Sintaxis

SECURITY_STATUS WINAPI SslGetProviderProperty(
  _In_    NCRYPT_PROV_HANDLE hSslProvider,
  _In_    LPCWSTR            pszProperty,
  _Out_   PBYTE              ppbOutput,
  _Out_   DWORD              *pcbOutput,
  _Inout_ PVOID              *ppEnumState,
  _In_    DWORD              dwFlags
);

Parámetros

hSslProvider [in]

Identificador del proveedor secure Sockets Layer (SSL) para el que se va a recuperar la propiedad .

pszProperty [in]

Puntero a una cadena Unicode terminada en null que contiene el nombre de la propiedad que se va a recuperar.

ppbOutput [out]

Dirección de un búfer que recibe el valor de propiedad.

El autor de la llamada de la función debe liberar este búfer llamando a la función SslFreeBuffer .

pcbOutput [out]

Tamaño, en bytes, del búfer pbOutput .

ppEnumState [in, out]

Dirección de un puntero VOID que recibe información de estado de enumeración que se usa en llamadas posteriores a esta función. Esta información solo tiene significado para el proveedor SSL y es opaco para el autor de la llamada. El proveedor SSL usa esta información para determinar qué elemento se encuentra a continuación en la enumeración. Si la variable a la que apunta este parámetro contiene NULL, la enumeración se inicia desde el principio.

El autor de la llamada de la función debe liberar esta memoria llamando a la función SslFreeBuffer .

dwFlags [in]

Este parámetro se reserva para uso futuro.

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_NO_MEMORY 0x8009000EL	No hay suficiente memoria disponible para asignar los búferes necesarios.
NTE_INVALID_HANDLE 0x80090026L	El identificador hSslProvider no es válido.
NTE_INVALID_PARAMETER 0x80090027L	Uno de los parámetros proporcionados no es válido.

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