IRDPSRAPIAttendee-Schnittstelle (rdpencomapi.h)
Teilnehmerobjekte werden als Ergebnis von Clients erstellt, die eine Verbindung mit der Sitzung herstellen und authentifiziert werden. Nachdem ein Teilnehmerobjekt erstellt wurde, wird es automatisch der Teilnehmerliste hinzugefügt. Sie können keine instance dieses Objekts erstellen. Anwendungen können auf folgende Weise Zugriff auf Teilnehmerobjekte erhalten:
- Wenn das IRDPSessionEvents::OnAttendeeConnected-Ereignis ausgelöst wird, ist der Parameter ein IDispatch-Zeiger , der dem erstellten Teilnehmerobjekt entspricht.
- Indem Sie auf die Attendee-Eigenschaft des AttendeeDisconnectInfo-Objekts zugreifen. Ein IDispatch-Zeiger auf dieses Objekt wird vom IRDPSessionEvents::OnAttendeeDisconnected-Ereignis ausgelöst. So werden Anwendungen darüber informiert, welcher Teilnehmer getrennt wurde.
- Durch Aufrufen der get_Item-Methode für die IRDPSRAPIAttendeeManager-Schnittstelle .
- Durch Aufrufen get_Next für den Enumerator, der von der IRDPSRAPIAttendeeManager::get__NewEnum-Methode zurückgegeben wird.
Vererbung
Die IRDPSRAPIAttendee-Schnittstelle erbt von der IDispatch-Schnittstelle . IRDPSRAPIAttendee verfügt auch über folgende Arten von Membern:
Methoden
Die IRDPSRAPIAttendee-Schnittstelle verfügt über diese Methoden.
| IRDPSRAPIAttendee::get_ConnectivityInfo Ruft die Konnektivitätsinformationen für den Teilnehmer ab. |
| IRDPSRAPIAttendee::get_ControlLevel Die Steuerungsebene, die der Teilnehmer über die Sitzung hat. (Abrufen) |
| IRDPSRAPIAttendee::get_Flags Ruft die teilnehmerspezifischen Flags ab, die im RDPENCOMAPI_ATTENDEE_FLAGS Enumerationstyp definiert sind. |
| IRDPSRAPIAttendee::get_Id Der eindeutige Bezeichner für den Teilnehmer. |
| IRDPSRAPIAttendee::get_Invitation Die Einladung, die verwendet wird, um dem Teilnehmer Zugriff auf die Konferenz zu gewähren. |
| IRDPSRAPIAttendee::get_RemoteName Der Name des Remoteclients. Dies ist in der Regel der Anzeigename des Teilnehmers. |
| IRDPSRAPIAttendee::p ut_ControlLevel Die Steuerungsebene, die der Teilnehmer über die Sitzung hat. (Put) |
| IRDPSRAPIAttendee::TerminateConnection Trennt den vom Teilnehmer dargestellten Client. |
Hinweise
Anwendungen sollten keine Zeiger auf Teilnehmerobjekte speichern. Die Lebensdauer des Teilnehmerobjekts hängt von der Lebensdauer des RDPSession-Objekts ab. Es hängt auch davon ab, ob sich die Sitzung noch im geöffneten Zustand befindet und ob der Client, der dem Teilnehmerobjekt entspricht, weiterhin mit der Sitzung verbunden ist. Anwendungen können Verweise auf Teilnehmerobjekte beibehalten, aber das Aufrufen einiger Methoden darauf, nachdem der Client getrennt wurde oder nachdem die Sitzung zerstört wurde, gibt E_UNEXPECTED Fehler zurück.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | rdpencomapi.h |