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 ). |