IUserNotification interface (shobjidl_core.h)
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) |