IMsTscAxEvents::OnAutoReconnecting-Methode

Wird aufgerufen, wenn ein Client automatisch eine Verbindung mit einem Remotedesktopsitzungshostserver (RD-Sitzungshost) herstellt.

Syntax

void OnAutoReconnecting(
  [in]  LONG                       disconnectReason,
  [in]  LONG                       attemptCount,
  [out] AutoReconnectContinueState *pArcContinueStatus
);

Parameter

disconnectReason [in]

Code, der den Grund für die letzte Sitzungsverbindung beschreibt.

attemptCount [in]

Anzahl der Versuche, die im aktuellen automatischen Wiederverbindungsprozess vorgenommen wurden. Diese Anzahl erhöht sich um einen für jeden Versuch vorgenommenen Versuch.

pArcContinueStatus [out]

Zeiger auf einen zurückgegebenen Code, der den Zustand des automatischen Verbindungsvorgangs angibt. Dieser Code kann zurückgesetzt werden, um den Status des aktuellen automatischen Wiederverbindungsprozesses zu ändern.

Weitere Informationen zum Zurücksetzen dieses Codes finden Sie im Abschnitt "Hinweise".

autoReconnectContinueAutomatic (0)

Die Erneute Verbindung wird automatisch ausgeführt. Dies ist der Standardwert.

autoReconnectContinueStop (1)

Der Erneute Verbindungsprozess wurde beendet.

autoReconnectContinueManual (2)

Die Erneute Verbindung wird manuell ausgeführt.

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Bemerkungen

Implementieren Sie diese Methode in Ihrem Ereignis sinken, um Benachrichtigungen zu erhalten, dass das Steuerelement eine Verbindung mit einem RD-Sitzungshostserver neu herstellt.

Wenn der Zustand des automatischen Reconnectionsprozesses geändert wird, indem der Wert des pArcContinueStatus-Parameters auf autoReconnectContinueAutomatic festgelegt wird, funktioniert diese Methode in einem reinen Beratungsmodus. Container können dieses Ereignis für Benachrichtigungen hören, bei denen die automatische Erneute Verbindung fortgesetzt wird. Das Steuerelement versucht automatisch, eine Verbindung basierend auf dem eigenen internen Zeitpunkt und der Anzahl der Versuche erneut herzustellen. Diese Methode wird während jedes automatischen Erneutverbindungsversuchs aufgerufen, um den Container zu benachrichtigen.

Wenn der Zustand des automatischen Reconnection-Prozesses geändert wird, indem der Wert des pArcContinueStatus-Parameters auf autoReconnectContinueStop festgelegt wird, wird der aktuelle automatische Reconnection-Versuch beendet, wird eine Trennbenachrichtigung an den Container gesendet, und keine weiteren automatischen Reconnectbenachrichtigungen werden ausgestellt.

Hinweis

Verwenden Sie die EnableAutoReconnect-Eigenschaft , um die automatische Verbindung zu aktivieren oder zu deaktivieren.

Wenn der Zustand des automatischen Reconnection-Prozesses geändert wird, indem der Wert des pArcContinueStatus-Parameters auf autoReconnectContinueManual festgelegt wird, steuert der Container den automatischen Wiederverbindungsprozess manuell, indem Verbinden aufgerufen wird, um einen Verbindungsversuch zu auslösen oder eine Verbindung zu trennen, um die automatische Erneute Verbindung abzubrechen. Sobald dieser Wert festgelegt ist, wird das Steuerelement beendet, automatische Wiederverbindungsversuche vorzunehmen, und es wird die Richtlinie des Containers, Verbinden Aufrufe vorzunehmen, um automatische Wiederverbindungsversuche auszulösen. Dies geschieht, wenn der Container benutzerdefiniertes UI-Verhalten für die automatische Erneute Verbindung bereitstellt, z. B. neustarten einer abgelegten RAS- oder VPN-Verbindung vor dem automatischen Erneutverbindungsprozess.

Weitere Informationen zur Remotedesktopwebverbindung finden Sie unter Anforderungen für Remotedesktopwebverbindung.

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Vista
Unterstützte Mindestversion (Server)
Windows Server 2008
Typbibliothek
MsTscAx.dll
DLL
MsTscAx.dll

Weitere Informationen

IMsTscAxEvents