IConnectionBrokerClient::GetTargetInfo (método)

Solicita información sobre el equipo de destino en el que se debe redirigir la conexión. El redirector usa este método para obtener información de redireccionamiento para la solicitud de conexión entrante.

Sintaxis

HRESULT GetTargetInfo(
  [in]  CB_CONNECTION_INFO       *pConnectionInfo,
  [in]  DWORD                    Reserved,
  [in]  HANDLE                   hStatusEvent,
  [out] CB_TARGET_INFO           *pTargetInfo,
  [out] DWORD                    *pResult,
  [out] IConnectionBrokerRequest **ppCbReq
);

Parámetros

pConnectionInfo [in]

Dirección de una estructura de CB_CONNECTION_INFO que contiene información sobre la solicitud de conexión entrante.

Reservado [in]

Este parámetro está reservado para uso futuro y debe ser cero.

hStatusEvent [in]

Identificador de un evento que se establecerá cada vez que haya una actualización en el progreso de la solicitud. Usted es responsable de crear y cerrar este evento.

pTargetInfo [out]

Dirección de una estructura de CB_TARGET_INFO que recibe información sobre el equipo de destino donde se debe redirigir la conexión entrante. Dado que se trata de un método asincrónico, esta memoria debe permanecer disponible hasta que se complete la solicitud. Para obtener más información, vea la sección Comentarios.

pResult [out]

Dirección de una variable DWORD que recibe un código de resultado. Dado que se trata de un método asincrónico, esta memoria debe permanecer disponible hasta que se complete la solicitud. Para obtener más información, vea la sección Comentarios.

Este código de resultado será uno de los siguientes valores.

0

Correcto.

0x0000400

No se encontró el equipo de destino.

0x0000401

El equipo de destino no está disponible.

0x0000402

Error al cargar el equipo de destino.

0x0000403

Error al poner el equipo de destino en línea.

0x0000404

Error al redirigir al equipo de destino.

0x0000405

Error al despertar de la máquina virtual.

0x0000406

Error al arrancar la máquina virtual.

0x0000407

Error al encontrar la dirección IP de la máquina virtual.

0x0000408

El agente de sesión no encontró ningún equipo disponible en el grupo.

0x0000409

El agente de sesión canceló la conexión.

0x0000410

El agente de sesión no pudo validar la configuración de conexión.

ppCbReq [out]

Dirección de un puntero de interfaz IConnectionBrokerRequest que se usa para obtener actualizaciones de estado para una operación asincrónica. Esta interfaz se usa junto con el parámetro hStatusEvent para esperar y obtener los resultados de esta operación asincrónica.

Valor devuelto

Devuelve E_PENDING si se crea la solicitud asincrónica. De lo contrario, devuelve un código de error HRESULT .

Comentarios

Este método es asincrónico. Los parámetros pTargetInfo y pResult deben permanecer válidos hasta que el método IConnectionBrokerRequest::CheckStatus obtenga CB_STATUS_REQUEST_COMPLETED.

Para obtener más información sobre cómo usar este método, consulte Uso de la API de cliente del Agente de conexión a Escritorio remoto.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8
Servidor mínimo compatible	Windows Server 2012
Encabezado	Cbclient.h
Biblioteca	Cbclient.lib
Archivo DLL	Cbclient.dll

Consulte también

IConnectionBrokerClient