Compartir a través de

Función WTSQueryListenerConfigA (wtsapi32.h)

  • Artículo

Recupera información de configuración de un agente de escucha de Servicios de Escritorio remoto.

Sintaxis

BOOL WTSQueryListenerConfigA(
  [in]  HANDLE              hServer,
  [in]  PVOID               pReserved,
  [in]  DWORD               Reserved,
  [in]  LPSTR               pListenerName,
  [out] PWTSLISTENERCONFIGA pBuffer
);

Parámetros

[in] hServer

Identificador de un servidor host de sesión de Escritorio remoto. Establezca siempre este parámetro en WTS_CURRENT_SERVER_HANDLE.

[in] pReserved

Este parámetro está reservado. Establezca siempre este parámetro en NULL.

[in] Reserved

Este parámetro está reservado. Establezca siempre este parámetro en cero.

[in] pListenerName

Puntero a una cadena terminada en null que contiene el nombre del agente de escucha que se va a consultar.

[out] pBuffer

Puntero a una estructura de WTSLISTENERCONFIG que recibe la información de configuración del agente de escucha recuperada.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un valor distinto de cero.

Si se produce un error en la función, el valor devuelto es cero. Para obtener información de error extendida, llame a la función GetLastError.

Observaciones

Esta función no recupera el descriptor de seguridad para el agente de escucha. Para recuperar el descriptor de seguridad, llame a la función WTSGetListenerSecurity.

Nota

El encabezado wtsapi32.h define WTSQueryListenerConfig como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows 7
servidor mínimo admitido Windows Server 2008 R2
de la plataforma de destino de Windows
encabezado de wtsapi32.h
biblioteca de Wtsapi32.lib
DLL de Wtsapi32.dll

Consulte también

WTSGetListenerSecurity

WTSLISTENERCONFIG