IUserNotification interface (shobjidl_core.h)

Article
07/27/2022

Exposes methods that set notification information and then display that notification to the user in a balloon that appears in conjunction with the notification area of the taskbar.

Note IUserNotification2 differs from IUserNotification only in its Show method, which adds an additional parameter for a callback interface to communicate with the notification. Otherwise the two interfaces are identical in form and function. CLSID_UserNotification implements both versions of Show as an overload.

Inheritance

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

Methods

The IUserNotification interface has these methods.


IUserNotification::PlaySound Plays a sound in conjunction with the notification. (IUserNotification.PlaySound)
IUserNotification::SetBalloonInfo Sets the information to be displayed in a balloon notification. (IUserNotification.SetBalloonInfo)
IUserNotification::SetBalloonRetry Specifies the conditions for trying to display user information when the first attempt fails. (IUserNotification.SetBalloonRetry)
IUserNotification::SetIconInfo Sets the notification area icon associated with specific user information. (IUserNotification.SetIconInfo)
IUserNotification::Show Displays the notification.

Remarks

When to Implement

An implementation of this interface is provided in Windows as CLSID_UserNotification.

Requirements

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