Partager via

IRDPSRAPIViewer::StartReverseConnectListener, méthode (rdpencomapi.h)

  • Article

[L’interface IRDPSRAPIViewer n’est plus disponible pour les applications UWP depuis Windows 10, version 1709. Il est toujours pris en charge pour les applications de bureau.]

Initie un écouteur pour accepter les connexions inversées du partageur à la visionneuse, ou obtient la chaîne de connexion que le partageur utilise pour inverser la connexion à la visionneuse.

Syntaxe

HRESULT StartReverseConnectListener(
  [in]  BSTR bstrConnectionString,
  [in]  BSTR bstrUserName,
  [in]  BSTR bstrPassword,
  [out] BSTR *pbstrReverseConnectString
);

Paramètres

[in] bstrConnectionString

Type : BSTR

Chaîne de connexion que le partageur utilisera pour démarrer l’écouteur.

[in] bstrUserName

Type : BSTR

Nom d’utilisateur à utiliser pour l’authentification.

[in] bstrPassword

Type : BSTR

Mot de passe à utiliser pour l’authentification.

[out] pbstrReverseConnectString

Type : BSTR*

Pointeur vers un BSTR qui reçoit la chaîne de connexion que le partageur peut utiliser pour inverser la connexion à la visionneuse à l’aide de la méthode IRDPSRAPISharingSession::ConnectToClient .

Valeur retournée

Type : HRESULT

Si la méthode réussit, la valeur de retour est S_OK. Sinon, la valeur de retour est un code d’erreur.

Notes

Cette méthode est utilisée pour effectuer deux opérations distinctes :

  • La première consiste à permettre à la visionneuse d’obtenir la chaîne de connexion que le partageur utilise pour inverser la connexion à la visionneuse. Pour ce faire, les paramètres bstrConnectionString, bstrUserName et bstrPassword doivent tous avoir la valeur NULL. La visionneuse envoie ensuite cette chaîne de connexion au partageur dans une méthode définie par l’application, telle que le stockage de la chaîne de connexion dans un fichier et le partage du fichier avec le partageur.
  • La deuxième opération consiste à lancer un écouteur qui watch pour les tentatives de connexion inversée à partir du partageur. Pour cette opération, le paramètre pbstrReverseConnectString doit être NULL.
La séquence normale d’événements pour cette procédure est la suivante :
  1. La visionneuse obtient sa chaîne de connexion en appelant la méthode StartReverseConnectListener , en passant la valeur NULL pour les paramètres bstrConnectionString, bstrUserName et bstrPassword .
  2. La visionneuse lance un écouteur de connexion inversée en appelant la méthode StartReverseConnectListener , en transmettant NULL pour le paramètre pbstrReverseConnectString et les valeurs valides pour les paramètres bstrConnectionString, bstrUserName et bstrPassword .
  3. La visionneuse envoie la chaîne de connexion obtenue à l’étape 1 au partageur.

Spécifications

   
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête rdpencomapi.h
DLL RdpEncom.dll

Voir aussi

IRDPSRAPIViewer