Partager via

IRDPSRAPIViewer ::Connect, 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.]

Démarre la connexion réelle au partageur.

Syntaxe

HRESULT Connect(
  [in] BSTR bstrConnectionString,
  [in] BSTR bstrName,
  [in] BSTR bstrPassword
);

Paramètres

[in] bstrConnectionString

Type : BSTR

Le chaîne de connexion utilisé pour se connecter au partageur et authentifier la visionneuse.

[in] bstrName

Type : BSTR

Nom de la visionneuse. Le nom est envoyé au partageur et aux autres visionneuses. La chaîne est limitée à 255 caractères.

[in] bstrPassword

Type : BSTR

Mot de passe utilisé pour l’authentification. Le mot de passe est envoyé hors bande à partir du partageur.

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.

Remarques

Les chaîne de connexion contenues dans le paramètre bstrConnectionString sont générées par le partageur et obtenues par la visionneuse en effectuant les étapes suivantes :

  1. Le partageur obtient une instance de l’interface IRDPSRAPIInvitationManager à partir de la propriété IRDPSRAPISharingSession ::Invitations.
  2. Le partageur obtient une instance de l’interface IRDPSRAPIInvitation en appelant la méthode IRDPSRAPIInvitationManager ::CreateInvitation.
  3. Le partageur obtient le chaîne de connexion à partir de la propriété IRDPSRAPIInvitation ::ConnectionString.
  4. Le partageur envoie le chaîne de connexion à la visionneuse dans une méthode définie par l’application, telle que le stockage des chaîne de connexion dans un fichier et le partage du fichier avec la visionneuse.
Pour renforcer la sécurité, les applications peuvent associer des mots de passe à une invitation côté partageur. Ces mots de passe sont généralement distribués aux spectateurs par le biais d’un mécanisme autre que celui utilisé pour envoyer les chaîne de connexion. Il s’agit d’empêcher le réseau de « renifler » les types d’attaques. Si un mot de passe est associé à une invitation, le mot de passe doit être transmis via cette API. Dans le cas contraire, le participant sera déconnecté.

La chaîne bstrName définie dans cette propriété est envoyée au partageur après le démarrage de la connexion. La propriété est un nom convivial que l’application sharer peut choisir d’afficher. La propriété est utile lorsqu’une invitation est utilisée pour authentifier plusieurs participants, car elle permet au partageur et aux autres visionneuses d’identifier qui participe à une session de partage windows Desktop.

Configuration requise

Condition requise Valeur
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