RemoteSystemWatcher Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Controlla l'attività correlata all'individuazione dei sistemi remoti e genera gli eventi appropriati.
public ref class RemoteSystemWatcher sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 196608)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class RemoteSystemWatcher final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 196608)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class RemoteSystemWatcher
Public NotInheritable Class RemoteSystemWatcher
- Ereditarietà
- Attributi
Requisiti Windows
Famiglia di dispositivi |
Windows 10 Anniversary Edition (è stato introdotto in 10.0.14393.0)
|
API contract |
Windows.Foundation.UniversalApiContract (è stato introdotto in v3.0)
|
Funzionalità dell'app |
remoteSystem
|
Commenti
Questa classe viene creata un'istanza quando viene chiamato il metodo statico CreateWatcher . Gli oggetti di questa classe iniziano a guardare l'attività quando viene chiamato il metodo Start e si arresta quando viene chiamato Stop , quando l'app viene chiusa o sospesa dal sistema o se si verifica un errore.
Importante
È necessario confermare l'accesso alla piattaforma di sistema remota con una chiamata a RemoteSystem.RequestAccessAsync prima di creare un'istanza di questa classe.
Cronologia delle versioni
Versione di Windows | Versione dell'SDK | Valore aggiunto |
---|---|---|
1803 | 17134 | EnumerationCompleted |
1803 | 17134 | ErrorOccurred |
1903 | 18362 | Utente |
Proprietà
User |
Rappresenta l'utente per cui RemoteSystemWatcher intende visualizzare i dispositivi. |
Metodi
Start() |
Inizia a guardare i sistemi remoti individuabili. Il processo di individuazione viene eseguito fino a quando non viene chiamato il metodo Stop o si verifica un errore. Un oggetto RemoteSystemWatcher può avere il relativo metodo Start chiamato di nuovo in un secondo momento. |
Stop() |
Smette di guardare i sistemi remoti individuabili. |
Eventi
EnumerationCompleted |
Questo evento viene generato al termine del processo iniziale di individuazione remota del sistema. |
ErrorOccurred |
Questo evento viene generato quando si verifica un errore durante l'individuazione. Se possibile, il processo di individuazione continuerà. Ad esempio, se l'errore si verifica con un valore RemoteSystemWatcherError.InternetNotAvailable (vedere RemoteSystemWatcherError), l'individuazione prossima continuerà perché l'errore si applica solo a Cloud Discovery (vedere RemoteSystemDiscoveryType). |
RemoteSystemAdded |
Evento generato quando viene individuato un nuovo sistema remoto (dispositivo). |
RemoteSystemRemoved |
Evento generato quando un sistema remoto (dispositivo) individuato in precedenza non è più visibile. |
RemoteSystemUpdated |
Generato quando un sistema remoto (dispositivo) individuato in precedenza in questa sessione di individuazione cambia da connesso al cloud o viceversa. Viene generato anche quando un sistema remoto modifica una delle relative proprietà monitorate (vedere le proprietà della classe RemoteSystem ). |