PeerWatcher.Stopped Event

Reference

Definition

Namespace:: Windows.Networking.Proximity

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Edit

Occurs when the PeerWatcher object has been stopped.

// Register
event_token Stopped(TypedEventHandler<PeerWatcher, IInspectable const&> const& handler) const;

// Revoke with event_token
void Stopped(event_token const* cookie) const;

// Revoke with event_revoker
PeerWatcher::Stopped_revoker Stopped(auto_revoke_t, TypedEventHandler<PeerWatcher, IInspectable const&> const& handler) const;

public event TypedEventHandler<PeerWatcher,object> Stopped;

function onStopped(eventArgs) { /* Your code */ }
peerWatcher.addEventListener("stopped", onStopped);
peerWatcher.removeEventListener("stopped", onStopped);
- or -
peerWatcher.onstopped = onStopped;

Public Custom Event Stopped As TypedEventHandler(Of PeerWatcher, Object)

Event Type

TypedEventHandler<PeerWatcher,Object>

TypedEventHandler<PeerWatcher,IInspectable>

Windows requirements

App capabilities

proximity

Remarks

You can call the Stop method to stop the PeerWatcher object. You can register for the Stopped event to be informed when the PeerWatcher has stopped. You must wait for the Stopped event before you can call the Start method to restart the PeerWatcher.

private PeerWatcher _peerWatcher;
private bool _peerWatcherIsRunning = false;
private bool _peerFinderStarted = false;

// The list of peers discovered by the PeerWatcher.
ObservableCollection<PeerInformation> _discoveredPeers = new ObservableCollection<PeerInformation>();
void PeerFinder_StartPeerWatcher(object sender, RoutedEventArgs e)
{
    if (!_peerFinderStarted)
    {
        // PeerFinder must be started first.
        return;
    }

    if (_peerWatcherIsRunning)
    {
        // PeerWatcher is already running.
        return;
    }

    try
    {
        if (_peerWatcher == null)
        {
            _peerWatcher = PeerFinder.CreateWatcher();

            // Add PeerWatcher event handlers. Only add handlers once.
            _peerWatcher.Added += PeerWatcher_Added;
            _peerWatcher.Removed += PeerWatcher_Removed;
            _peerWatcher.Updated += PeerWatcher_Updated;
            _peerWatcher.EnumerationCompleted += PeerWatcher_EnumerationCompleted;
            _peerWatcher.Stopped += PeerWatcher_Stopped;
        }

        // Empty the list of discovered peers.
        _discoveredPeers.Clear();

        // Start the PeerWatcher.
        _peerWatcher.Start();

        _peerWatcherIsRunning = true;
    }
    catch (Exception ex)
    {
        // Exceptions can occur if PeerWatcher.Start is called multiple times or
        // PeerWatcher.Start is called the PeerWatcher is stopping.
    }
}

protected override void OnNavigatingFrom(NavigatingCancelEventArgs e)
{
    if (_peerWatcher != null)
    {
        // Remove event handlers.
        _peerWatcher.Added -= PeerWatcher_Added;
        _peerWatcher.Removed -= PeerWatcher_Removed;
        _peerWatcher.Updated -= PeerWatcher_Updated;
        _peerWatcher.EnumerationCompleted -= PeerWatcher_EnumerationCompleted;
        _peerWatcher.Stopped -= PeerWatcher_Stopped;

        _peerWatcher = null;
    }
}

private void PeerWatcher_Stopped(PeerWatcher sender, object o)
{
    _peerWatcherIsRunning = false;
    var result = Dispatcher.RunAsync(CoreDispatcherPriority.Low, () =>
    {
        // Update UI now that the PeerWatcher is stopped.
    });
}

Applies to