SHNotificationGetData

  • Article

The SHNotificationGetData function gets the data for a notification. It is available for querying back the data to another application.

LRESULT SHNotificationGetData(
  const CLSID * pclsid, 
  DWORD dwID,
  SHNOTIFICATIONDATA * pndBuffer
);

Parameters

  • pclsid
    The class of the notification.
  • dwID
    The unique identifier for the notification.
  • pndBuffer
    Reference to a buffer to receive the notification data.

Return Values

ERROR_SUCCESS indicates success.

Remarks

Upon successful return from this function, pndBuffer->pszHTML and pndBuffer->pszTitle are owned by and must be freed by the caller.

SHNotificationGetData cannot be used for notifications without a CLSID. ERROR_INVALID_PARAMETER is returned when a NULL CLSID is given. To create a classless notification, use a CLSID of {0000-0000-...-00000000}.

SHNotificationGetData (&CLSID_x, dwID, NULL) doesn't return whether a particular notification is present or not. The return value is 0x491.

Requirements

Smartphone: Not Supported
Pocket PC: Windows Mobile 2002 and later
OS Versions: Windows CE 3.0 and later
Header: aygshell.h
Library: aygshell.lib

Send feedback on this topic to the authors.

© 2005 Microsoft Corporation. All rights reserved.