Partilhar via


RemoteSystemWatcher Classe

Definição

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
Object Platform::Object IInspectable RemoteSystemWatcher
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 ).

Aplica-se a

Confira também