IMsTscAxEvents::OnAutoReconnecting-Methode
Wird aufgerufen, wenn ein Client dabei ist, eine Sitzung automatisch wieder mit einem Remotedesktopsitzungshostserver (RD-Sitzungshost) zu verbinden.
Syntax
void OnAutoReconnecting(
[in] LONG disconnectReason,
[in] LONG attemptCount,
[out] AutoReconnectContinueState *pArcContinueStatus
);
Parameter
-
disconnectReason [in]
-
Code, der den Grund für die letzte Sitzungsunterbrechung beschreibt.
-
attemptCount [in]
-
Anzahl der Versuche, die im aktuellen automatischen Wiederverbindungsprozess durchgeführt wurden. Diese Anzahl erhöht sich für jeden versuchten Versuch um einen.
-
pArcContinueStatus [out]
-
Zeiger auf einen zurückgegebenen Code, der den Status des automatischen Verbindungsherstellungsprozesses angibt. Dieser Code kann zurückgesetzt werden, um den Status des aktuellen automatischen Verbindungsherstellungsprozesses zu ändern.
Weitere Informationen zum Zurücksetzen dieses Codes finden Sie im Abschnitt Hinweise.
-
autoReconnectContinueAutomatic (0)
-
Der Verbindungswiederholungsvorgang erfolgt automatisch. Dies ist der Standardwert.
-
autoReconnectContinueStop (1)
-
Der Vorgang zur Wiederherstellung der Verbindung wurde beendet.
-
autoReconnectContinueManual (2)
-
Der Verbindungswiederholungsvorgang erfolgt manuell.
Rückgabewert
Diese Methode gibt keinen Wert zurück.
Bemerkungen
Implementieren Sie diese Methode in Ihrer Ereignissenke, um eine Benachrichtigung zu erhalten, dass das Steuerelement eine Verbindung mit einem RD-Sitzungshostserver wiederhergestellt.
Wenn der Zustand des automatischen Verbindungsherstellungsprozesses geändert wird, indem der Wert des pArcContinueStatus-Parameters auf autoReconnectContinueAutomatic festgelegt wird, funktioniert diese Methode in einem rein beratenden Modus. Container können auf dieses Ereignis lauschen, um Benachrichtigungen darüber zu erhalten, dass der automatische Verbindungsherstellungsprozess fortgesetzt wird. Das Steuerelement versucht automatisch, eine Verbindung basierend auf seinem eigenen internen Timing und der Anzahl der Versuche erneut herzustellen. Diese Methode wird bei jedem automatischen Verbindungsversuch aufgerufen, um den Container zu benachrichtigen.
Wenn der Status des automatischen Wiederverbindungsprozesses geändert wird, indem der Wert des pArcContinueStatus-Parameters auf autoReconnectContinueStop festgelegt wird, wird der aktuelle automatische Verbindungsversuch beendet, eine Trennungsbenachrichtigung 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 Erneute Verbindung zu aktivieren oder zu deaktivieren.
Wenn der Zustand des prozesses für die automatische Wiederherstellung geändert wird, indem der Wert des pArcContinueStatus-Parameters auf autoReconnectContinueManual festgelegt wird, steuert der Container manuell den automatischen Wiederverbindungsprozess, indem er Connect aufruft, um einen Verbindungsversuch auszulösen, oder Trennen, um den automatischen Verbindungsvorgang abzubrechen. Sobald dieser Wert festgelegt ist, führt das Steuerelement keine automatischen Verbindungsversuche mehr durch, und es wird zur Richtlinie des Containers, um Connect-Aufrufe auszuführen, um automatische Verbindungsversuche auszulösen. Dies geschieht, wenn der Container ein angepasstes Benutzeroberflächenverhalten für die automatische Wiederherstellung der Verbindung bereitstellt, z. B. das Neustarten einer gelöschten RAS- oder VPN-Verbindung vor dem automatischen Verbindungsherstellungsprozess.
Weitere Informationen zur Remotedesktop-Webverbindung finden Sie unter Anforderungen für die Remotedesktopwebverbindung.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
WindowsServer 2008 |
| Typbibliothek |
|
| DLL |
|