RemoteSystemWatcher Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Observa a atividade relacionada à descoberta de sistemas remotos e gera os eventos apropriados.
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
- Herança
- Atributos
Requisitos do Windows
Família de dispositivos |
Windows 10 Anniversary Edition (introduzida na 10.0.14393.0)
|
API contract |
Windows.Foundation.UniversalApiContract (introduzida na v3.0)
|
Funcionalidades do aplicativo |
remoteSystem
|
Comentários
Essa classe é instanciada quando o método estático CreateWatcher é chamado. Os objetos dessa classe começam a observar a atividade quando o método Start é chamado e param quando Stop é chamado, quando o aplicativo sai ou é suspenso pelo sistema ou se ocorre um erro.
Importante
Você deve confirmar o acesso à plataforma do sistema remoto com uma chamada para RemoteSystem.RequestAccessAsync antes de instanciar essa classe.
Histórico de versão
Versão do Windows | Versão do SDK | Valor adicionado |
---|---|---|
1803 | 17134 | EnumerationCompleted |
1803 | 17134 | ErrorOccurred |
1903 | 18362 | Usuário |
Propriedades
User |
Representa o usuário para o qual o RemoteSystemWatcher pretende ver os dispositivos. |
Métodos
Start() |
Começa a observar sistemas remotos detectáveis. O processo de descoberta é executado até que o método Stop seja chamado ou ocorra um erro. Um objeto RemoteSystemWatcher pode ter seu método Start chamado novamente posteriormente. |
Stop() |
Para de observar sistemas remotos detectáveis. |
Eventos
EnumerationCompleted |
Esse evento é gerado quando o processo inicial de descoberta do sistema remoto é concluído. |
ErrorOccurred |
Esse evento é gerado quando ocorre um erro durante a descoberta. O processo de descoberta continuará, se possível. Por exemplo, se o erro ocorrer com um valor de RemoteSystemWatcherError.InternetNotAvailable (consulte RemoteSystemWatcherError), a descoberta proximal continuará porque o erro se aplica apenas à descoberta de nuvem (consulte RemoteSystemDiscoveryType). |
RemoteSystemAdded |
O evento gerado quando um novo sistema remoto (dispositivo) é descoberto. |
RemoteSystemRemoved |
O evento gerado quando um sistema remoto (dispositivo) descoberto anteriormente não está mais visível. |
RemoteSystemUpdated |
Gerado quando um sistema remoto (dispositivo) que foi descoberto anteriormente nesta sessão de descoberta muda de conectado proximicamente à nuvem conectada ou ao inverso. Ele também é gerado quando um sistema remoto altera uma de suas propriedades monitoradas (consulte as propriedades da classe RemoteSystem ). |