Método IConnectionBrokerClient::GetTargetInfo

Solicita informações sobre o computador de destino em que a conexão deve ser redirecionada. Esse método é usado pelo redirecionador para obter informações de redirecionamento para a solicitação de conexão de entrada.

Sintaxe

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]

O endereço de uma estrutura CB_CONNECTION_INFO que contém informações sobre a solicitação de conexão de entrada.

Reservado [in]

Esse parâmetro é reservado para uso futuro e deve ser zero.

hStatusEvent [in]

O identificador de um evento que será definido sempre que houver uma atualização para o progresso da solicitação. Você é responsável por criar e fechar esse evento.

pTargetInfo [out]

O endereço de uma estrutura CB_TARGET_INFO que recebe informações sobre o computador de destino em que a conexão de entrada deve ser redirecionada. Como esse é um método assíncrono, essa memória deve permanecer disponível até que a solicitação seja concluída. Para obter mais informações, consulte Comentários.

pResult [out]

O endereço de uma variável DWORD que recebe um código de resultado. Como esse é um método assíncrono, essa memória deve permanecer disponível até que a solicitação seja concluída. Para obter mais informações, consulte Comentários.

Esse código de resultado será um dos valores a seguir.

0

Sucesso.

0x0000400

Não foi possível encontrar o computador de destino.

0x0000401

O computador de destino não está disponível.

0x0000402

Erro ao carregar o computador de destino.

0x0000403

Erro ao colocar o computador de destino online.

0x0000404

Erro ao redirecionar para o computador de destino.

0x0000405

Erro ao acordar a máquina virtual.

0x0000406

Erro ao inicializar a máquina virtual.

0x0000407

Erro ao localizar o endereço IP da máquina virtual.

0x0000408

O agente de sessão não pôde encontrar computadores disponíveis no pool.

0x0000409

O agente de sessão cancelou a conexão.

0x0000410

O agente de sessão não pôde validar as configurações de conexão.

ppCbReq [out]

O endereço de um ponteiro de interface IConnectionBrokerRequest que você usa para obter atualizações status para uma operação assíncrona. Essa interface é usada em conjunto com o parâmetro hStatusEvent para aguardar e obter os resultados dessa operação assíncrona.

Valor retornado

Retorna E_PENDING se a solicitação assíncrona for criada. Caso contrário, ele retornará um código de erro HRESULT .

Comentários

Esse método é assíncrono. Os parâmetros pTargetInfo e pResult devem permanecer válidos até que o método IConnectionBrokerRequest::CheckStatus obtenha CB_STATUS_REQUEST_COMPLETED.

Para obter mais informações sobre como usar esse método, consulte Como usar a API de cliente do Agente de Conexão de Área de Trabalho Remota.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8
Servidor mínimo com suporte	Windows Server 2012
Cabeçalho	Cbclient.h
Biblioteca	Cbclient.lib
DLL	Cbclient.dll

Confira também

IConnectionBrokerClient