Función TLSGetServerCertificate

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