IMsTscAxEvents::OnAutoReconnecting-Methode
Wird aufgerufen, wenn ein Client gerade eine Sitzung automatisch mit einem Remotedesktop-Sitzungshost -Server (RD-Sitzungshost) verbindet.
Syntax
void OnAutoReconnecting(
[in] LONG disconnectReason,
[in] LONG attemptCount,
[out] AutoReconnectContinueState *pArcContinueStatus
);
Parameter
-
disconnectReason [ In]
-
Code, der den Grund für die letzte Sitzungstrennung beschreibt.
-
attemptCount [ In]
-
Anzahl der Versuche, die im aktuellen prozess der automatischen Wiederherstellung der Verbindung unternommen wurden. Diese Anzahl erhöht sich für jeden unternommenen Versuch um eins.
-
pArcContinueStatus [ out]
-
Zeiger auf einen zurückgegebenen Code, der den Zustand des automatischen Verbindungswiederherstellungsprozesses angibt. Dieser Code kann zurückgesetzt werden, um den Status des aktuellen prozesses für die automatische Wiederherstellung der Verbindung zu ändern.
Weitere Informationen zum Zurücksetzen dieses Codes finden Sie im Abschnitt "Hinweise".
-
autoReconnectContinueAutomatic® (0)
-
Der Prozess der erneuten Verbindung wird automatisch ausgeführt. Dies ist der Standardwert.
-
autoReconnectContinueStop® (1)
-
Der Prozess zum Wiederherstellen der Verbindung wurde beendet.
-
autoReconnectContinueManual® (2)
-
Der Prozess der erneuten Verbindung wird manuell ausgeführt.
Rückgabewert
Diese Methode gibt keinen Wert zurück.
Hinweise
Implementieren Sie diese Methode in Ihrer Ereignissenke, um eine Benachrichtigung zu erhalten, dass das Steuerelement eine Verbindung mit einem RD-Sitzungshost Server wieder hersetzt.
Wenn der Zustand des automatischen Verbindungswiederherstellungsprozesses geändert wird, indem der Wert des pArcContinueStatus-Parameters auf autoReconnectContinueAutomatic festgelegt wird, funktioniert diese Methode in einem reinen Empfehlungsmodus. Container können auf dieses Ereignis auf Benachrichtigungen lauschen, dass der automatische Verbindungswiederherstellungsprozess fortgesetzt wird. Das Steuerelement versucht automatisch weiterhin, eine Verbindung basierend auf seiner eigenen internen Zeitsteuerung und Der Anzahl der Versuche herzustellen. Diese Methode wird bei jedem automatischen Erneutverbindungsversuch aufgerufen, um den Container zu benachrichtigen.
Wenn der Status des automatischen Verbindungswiederherstellungsprozesses durch Festlegen des Werts des pArcContinueStatus-Parameters auf autoReconnectContinueStop geändert wird, wird der aktuelle Versuch der automatischen Erneutverbindung beendet, eine Benachrichtigung zum Trennen der Verbindung wird an den Container gesendet, und es werden keine weiteren automatischen Benachrichtigungen zur erneuten Verbindung ausgegeben.
Hinweis
Verwenden Sie die EnableAutoReconnect-Eigenschaft, um die automatische wiederherzustellende Verbindung zu aktivieren oder zu deaktivieren.
Wenn der Status des automatischen Verbindungswiederherstellungsprozesses durch Festlegen des Werts des pArcContinueStatus-Parameters auf autoReconnectContinueManual geändert wird, steuert der Container den automatischen Erneutverbindungsprozess manuell, indem er Verbinden aufruft, um einen Verbindungsversuch auszulösen, oder Trennen, um den automatischen Verbindungswiederherstellungsprozess abzubrechen. Sobald dieses Steuerelement auf diesen Wert festgelegt ist, werden keine automatischen Verbindungsversuche mehr unternommen, und es wird zur Richtlinie des Containers, Verbinden Aufrufe zum Auslösen automatischer Erneutverbindungsversuche vorzunehmen. Dies geschieht, wenn der Container ein benutzerdefiniertes Benutzeroberflächenverhalten für die automatische wiederherzustellende Verbindung bereitstellt, z. B. das Neustarten einer gelöschten RAS- oder VPN-Verbindung vor dem automatischen Erneut herstellen.
Weitere Informationen zu Remotedesktop-Webverbindung finden Sie unter Anforderungen für Remotedesktop-Webverbindung.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 |
| Typbibliothek |
|
| DLL |
|