Edit

Share via

NOTIFYICONIDENTIFIER structure (shellapi.h)

  • Article

Contains information used by Shell_NotifyIconGetRect to identify the icon for which to retrieve the bounding rectangle.

Syntax

typedef struct _NOTIFYICONIDENTIFIER {
  DWORD cbSize;
  HWND  hWnd;
  UINT  uID;
  GUID  guidItem;
} NOTIFYICONIDENTIFIER, *PNOTIFYICONIDENTIFIER;

Members

cbSize

Type: DWORD

The size of this structure, in bytes.

hWnd

Type: HWND

A handle to the parent window used by the notification's callback function. For more information, see the hWnd member of the NOTIFYICONDATA structure.

uID

Type: UINT

The application-defined identifier of the notification icon. Multiple icons can be associated with a single hWnd, each with their own uID.

guidItem

Type: GUID

A registered GUID that identifies the icon. Use GUID_NULL if the icon is not identified by a GUID.

Remarks

The icon can be identified to Shell_NotifyIconGetRect through this structure in two ways:

  • guidItem alone (recommended)
  • hWnd plus uID
If guidItem is not GUID_NULL, hWnd and uID are ignored.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Header shellapi.h