AppInstance.GetInstances Method

Definition

Namespace:

Microsoft.Windows.AppLifecycle

Retrieves a collection of all running instances of the app.

public:
 static IVector<AppInstance ^> ^ GetInstances();

 static IVector<AppInstance> GetInstances();

public static IList<AppInstance> GetInstances();

function getInstances()

Public Shared Function GetInstances () As IList(Of AppInstance)

Returns

IVector<AppInstance>

IList<AppInstance>

The collection of all running instances of the app.

Remarks

Whereas the Windows.ApplicationModel.AppInstance.GetInstances method in the Windows OS only returns app instances that have explicitly registered for multi-instance redirection using the FindOrRegisterInstanceForKey method, this method in the Windows App SDK returns a list of all running app instances that have called any AppInstance method. Typically, an app instance will call AppInstance.GetCurrent, and this does two things: it adds the current instance to the list that will get returned by the GetInstances method, and it returns the current instance.