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 |
|
| Biblioteca |
|
| Archivo DLL |
|