IApplicationAssociationRegistration interface (shobjidl_core.h)

Exposes methods that query and set default applications for specific file Association Type, and protocols at a specific Association Level.

Note  As of Windows 8, the only functionality of this interface that is supported is QueryCurrentDefault.


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


The IApplicationAssociationRegistration interface has these methods.


Removes all per-user associations for the current user. This results in a reversion to machine defaults, if they exist. Not intended for use in Windows 8.

Determines whether an application owns the registered default association for a given application level and type. Not intended for use in Windows 8.

Determines whether an application owns all of the registered default associations for a given application level. Not intended for use in Windows 8.

Determines the default application for a given association type. This is the default application launched by ShellExecute for that type.

Sets an application as the default for a given extension or protocol, provided that the application's publisher matches the current default's. For more information, see Default Programs. Not intended for use in Windows 8.

Sets an application as the default for all of the registered associations of any type for that application. Not intended for use in Windows 8.


Because IApplicationAssociationRegistration is only supported for Windows Vista and Windows 7, applications that support earlier operating systems must use their preexisting code in relation to defaults when running under those operating systems. Those applications should include a check for the operating system version to account for this.


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

See also

Default Programs