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 |
|