Edit

IApplicationActivationManager interface (shobjidl_core.h)

  • Article

Provides methods which activate Windows Store apps for the Launch, File, and Protocol extensions. You will normally use this interface in debuggers and design tools.

Inheritance

The IApplicationActivationManager interface inherits from the IUnknown interface. IApplicationActivationManager also has these types of members:

Methods

The IApplicationActivationManager interface has these methods.

 
IApplicationActivationManager::ActivateApplication

Activates the specified Windows Store app for the generic launch contract (Windows.Launch) in the current session.
IApplicationActivationManager::ActivateForFile

Activates the specified Windows Store app for the file contract (Windows.File).
IApplicationActivationManager::ActivateForProtocol

Activates the specified Windows Store app for the protocol contract (Windows.Protocol).

Remarks

When to Implement

Do not implement this interface yourself. Windows provides an implementation as part of the CApplicationActivationManager class. To get an instance of this class, call CoCreateInstance with the CLSID_ApplicationActivationManager class ID.

Usage notes

An IApplicationActivationManager object creates a thread in its host process to serve any activated event arguments objects (LaunchActivatedEventArgs, FileActivatedEventArgs, and ProtocolActivatedEventArgs) that are passed to the app. If the calling process is long-lived, you can create this object in-proc, based on the assumption that the event arguments will exist long enough for the target app to use them. However, if the calling process is spawned only to launch the target app, it should create the IApplicationActivationManager object out-of-process, by using CLSCTX_LOCAL_SERVER. This causes the object to be created in a Dllhost.exe instance that automatically manages the object's lifetime based on outstanding references to the activated event argument objects.

Requirements

Requirement Value
Minimum supported client Windows 8 [desktop apps only]
Minimum supported server Windows Server 2012 [desktop apps only]
Target Platform Windows
Header shobjidl_core.h (include Shobjidl.h)

See also

IUnknown