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 |
|
Bibliothèque |
|
DLL |
|