Función TLSGetServerCertificate

Artículo
06/12/2023

Devuelve el certificado del servidor de licencias de Escritorio remoto.

Nota

Esta función no tiene ningún archivo de encabezado asociado ni biblioteca de importación. Para llamar a esta función, debe crear un archivo de encabezado definido por el usuario y usar las funciones LoadLibrary y GetProcAddress para vincular dinámicamente a Mstlsapi.dll.

Sintaxis

DWORD WINAPI TLSGetServerCertificate(
  _In_  TLS_HANDLE hHandle,
  _In_  BOOL       bSignCert,
  _Out_ LPBYTE     *ppbCertBlob,
  _Out_ LPDWORD    lpdwCertBlobLen,
  _Out_ PDWORD     pdwErrCode
);

Parámetros

hHandle [in]: Controle a un servidor de licencias de Escritorio remoto abierto mediante una llamada a la función TLSConnectToLsServer .
bSignCert [in]: TRUE si el certificado de firma es FALSE si se intercambia el certificado.
ppbCertBlob [out]: Puntero a una variable que recibe un puntero a un búfer que contiene el certificado.
lpdwCertBlobLen [out]: Puntero a una variable que recibe el tamaño del certificado que se devuelve.
pdwErrCode [out]: Puntero a una variable que recibe el código de error.
LSERVER_S_SUCCESS (0): La llamada se realiza correctamente.
TLS_W_SELFSIGN_CERTIFICATE (4007): El certificado devuelto es un certificado autofirmado.
TLS_W_TEMP_SELFSIGN_CERT (4009): El certificado devuelto es temporal.
TLS_E_ACCESS_DENIED (5003): Acceso denegado.
TLS_E_ALLOCATE_HANDLE (5007): El servidor está demasiado ocupado para procesar la solicitud.
TLS_E_NO_CERTIFICATE (5022): No se puede recuperar un certificado.

Valor devuelto

Esta función devuelve los siguientes valores devueltos posibles.

RPC_S_OK: La llamada se realizó correctamente. Compruebe el valor del parámetro pdwErrCode para obtener el código de retorno de la llamada.
RPC_S_INVALID_ARG: El argumento no era válido.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Archivo DLL	Mstlsapi.dll

Consulte también

TLSConnectToLsServer

Share via