SHNotificationUpdate (Compact 7)

3/12/2014

This function updates aspects of a pending notification.

Syntax

LRESULT SHNotificationUpdate(
  DWORD grnumUpdateMask,
  SHNOTIFICATIONDATA* pndNew
);

Parameters

• grnumUpdateMask
  [in] Bitfield that consists of one or more flags which specify which members of pndNew are updated. The following table shows the possible flag values.

  Flag	Description
  SHNUM_PRIORITY	The npPriority member has been updated.
  SHNUM_DURATION	The csDuration member has been updated.
  SHNUM_ICON	The hicon member has been updated.
  SHNUM_HTML	The pszHTML member has been updated.
  SHNUM_TITLE	The pszTitle member has been updated.
  SHNUM_SOFTKEYS	The skm or rgskn member has been updated.
  SHNUM_TODAYKEY	The pszTodaySK member has been updated.
  SHNUM_TODAYEXEC	The pszTodayExec member has been updated.
  SHNUM_SOFTKEYCMDS	The skm or rgskn member and grfFlags member have been updated.
  SHNUM_FLAGS	The grfFlags member has been updated.

• pndNew
  [in] Pointer to an SHNOTIFICATIONDATA structure containing the new data to place into the notification. At a minimum, the dwId and clsid members of this structure must be specified for the correct notification in order for that notification to be updated.

Return Value

This function returns ERROR_SUCCESS when successful.

Remarks

The grnumUpdateMask parameter contains of one or more SHNUM_XXXX flags. When calling SHNotificationUpdate, the caller sets the bits in grnumUpdateMask and fills the corresponding members in pndNew. The other members are ignored.

When calling SHNotificationUpdate, set the bits in grnumUpdateMask and fill the corresponding members in pndNew. The other members are ignored.

Requirements

Header	aygshell.h
Library	aygshell.lib

See Also

Reference

AYGShell Functions
SHNotificationRemove
SHNotificationAdd
SHNotificationGetData
SHNOTIFICATIONDATA