Méthode IConnectionBrokerClient::GetTargetInfo

Demande des informations sur l’ordinateur cible sur lequel la connexion doit être redirigée. Cette méthode est utilisée par le redirecteur pour obtenir des informations de redirection pour la demande de connexion entrante.

Syntaxe

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

Paramètres

pConnectionInfo [in]

Adresse d’une structure de CB_CONNECTION_INFO qui contient des informations sur la demande de connexion entrante.

Réservé [in]

Ce paramètre est réservé pour une utilisation ultérieure et doit être égal à zéro.

hStatusEvent [in]

Handle d’un événement qui est défini chaque fois qu’il y a une mise à jour de la progression de la demande. Vous êtes responsable de la création et de la fermeture de cet événement.

pTargetInfo [out]

Adresse d’une structure de CB_TARGET_INFO qui reçoit des informations sur l’ordinateur cible où la connexion entrante doit être redirigée. Comme il s’agit d’une méthode asynchrone, cette mémoire doit rester disponible jusqu’à ce que la demande soit terminée. Pour plus d'informations, consultez la section Notes.

pResult [out]

Adresse d’une variable DWORD qui reçoit un code de résultat. Comme il s’agit d’une méthode asynchrone, cette mémoire doit rester disponible jusqu’à ce que la demande soit terminée. Pour plus d'informations, consultez la section Notes.

Ce code de résultat sera l’une des valeurs suivantes.

0

Réussite.

0x0000400

L’ordinateur de destination est introuvable.

0x0000401

L’ordinateur de destination n’est pas disponible.

0x0000402

Erreur lors du chargement de l’ordinateur de destination.

0x0000403

Erreur lors de la mise en ligne de l’ordinateur de destination.

0x0000404

Erreur lors de la redirection vers l’ordinateur de destination.

0x0000405

Erreur lors de la veille de la machine virtuelle.

0x0000406

Erreur lors du démarrage de la machine virtuelle.

0x0000407

Erreur lors de la recherche de l’adresse IP de la machine virtuelle.

0x0000408

Le répartiteur de sessions n’a trouvé aucun ordinateur disponible dans le pool.

0x0000409

Le répartiteur de session a annulé la connexion.

0x0000410

Le répartiteur de session n’a pas pu valider les paramètres de connexion.

ppCbReq [out]

Adresse d’un pointeur d’interface IConnectionBrokerRequest que vous utilisez pour obtenir status mises à jour pour une opération asynchrone. Cette interface est utilisée conjointement avec le paramètre hStatusEvent pour attendre et obtenir les résultats de cette opération asynchrone.

Valeur retournée

Retourne E_PENDING si la requête asynchrone est créée. Sinon, elle retourne un code d’erreur HRESULT .

Notes

Cette méthode est asynchrone. Les paramètres pTargetInfo et pResult doivent rester valides jusqu’à ce que la méthode IConnectionBrokerRequest::CheckStatus obtienne CB_STATUS_REQUEST_COMPLETED.

Pour plus d’informations sur l’utilisation de cette méthode, consultez Guide pratique pour utiliser l’API cliente Broker pour les connexions Bureau à distance.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 8
Serveur minimal pris en charge	Windows Server 2012
En-tête	Cbclient.h
Bibliothèque	Cbclient.lib
DLL	Cbclient.dll

Voir aussi

IConnectionBrokerClient