Metodo IMsTscAxEvents::OnAutoReconnecting

Chiamato quando un client si trova nel processo di riconnessione automatica di una sessione con un server Host sessione Desktop remoto (Host sessione Desktop remoto).

Sintassi

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

Parametri

disconnessioneReason [in]

Codice che descrive il motivo della disconnessione dell'ultima sessione.

attemptCount [in]

Numero di tentativi effettuati nel processo di riconnessione automatica corrente. Questo conteggio aumenta di uno per ogni tentativo effettuato.

pArcContinueStatus [out]

Puntatore a un codice restituito che specifica lo stato del processo di riconnessione automatica. Questo codice può essere reimpostato per modificare lo stato del processo di riconnessione automatica corrente.

Per altre informazioni sulla reimpostazione di questo codice, vedere la sezione Osservazioni.

autoReconnectContinueAutomatic (0)

Il processo di riconnessione si verifica automaticamente. Si tratta del valore predefinito.

autoReconnectContinueStop (1)

Il processo di riconnessione è stato arrestato.

autoReconnectContinueManual (2)

Il processo di riconnessione si sta verificando manualmente.

Valore restituito

Questo metodo non restituisce valori.

Commenti

Implementare questo metodo nel sink eventi per ricevere una notifica che il controllo sta rielaborando una connessione con un server Host sessione Desktop remoto.

Quando lo stato del processo di riconnessione automatica viene modificato impostando il valore del parametro pArcContinueStatus su autoReconnectContinueAutomatic, questo metodo funziona in modalità puramente consultiva. I contenitori possono ascoltare questo evento per le notifiche che il processo di riconnessione automatica sta procedendo. Il controllo manterrà automaticamente il tentativo di stabilire nuovamente una connessione in base al proprio tempo interno e ai conteggi dei tentativi. Questo metodo viene chiamato durante ogni tentativo di riconnessione automatica per notificare al contenitore.

Quando lo stato del processo di riconnessione automatica viene modificato impostando il valore del parametro pArcContinueStatus su autoReconnectContinueStop, il tentativo di riconnessione automatica corrente verrà terminato, verrà inviata una notifica di disconnessione al contenitore e non verranno inviate ulteriori notifiche di riconnessione automatica.

Nota

Usare la proprietà EnableAutoReconnect per abilitare o disabilitare la riconnessione automatica.

Quando lo stato del processo di riconnessione automatica viene modificato impostando il valore del parametro pArcContinueStatus su autoReconnectContinueManual, il contenitore controlla manualmente il processo di riconnessione automatica chiamando Connessione per attivare un tentativo di connessione o Disconnettersi per annullare il processo di riconnessione automatica. Dopo aver impostato su questo valore, il controllo smetterà di effettuare tentativi di riconnessione automatica e diventa il criterio del contenitore per effettuare chiamate Connessione per attivare tentativi di riconnessione automatica. Questa operazione viene eseguita quando il contenitore fornisce un comportamento personalizzato dell'interfaccia utente per la riconnessione automatica, ad esempio il riavvio di una connessione RAS o VPN eliminata prima del processo di riconnessione automatica.

Per altre informazioni sulla connessione Web Desktop remoto, vedere Requisiti per la connessione Web Desktop remoto.

Requisiti

Requisito Valore
Client minimo supportato
Windows Vista
Server minimo supportato
Windows Server 2008
Libreria dei tipi
MsTscAx.dll
DLL
MsTscAx.dll

Vedi anche

IMsTscAxEvents