TBN_GETOBJECT notification code

Sent by a toolbar control that uses the TBSTYLE_REGISTERDROP style to request a drop target object when the pointer passes over one of its buttons. This notification code is sent in the form of a WM_NOTIFY message.

TBN_GETOBJECT

    lpnmon = (LPNMOBJECTNOTIFY) lParam;

Parameters

lParam

Pointer to an NMOBJECTNOTIFY structure that contains information about the button that the pointer passed over and receives data the application provides in response to this notification code.

Return value

The application processing this notification code must return zero.

Remarks

To provide an object, an application must set values in some members of the NMOBJECTNOTIFY structure at lParam. The pObject member must be set to a valid object pointer, and the hResult member must be set to a success flag. To comply with Component Object Model (COM) standards, always increment the object's reference count when providing an object pointer.

If an application does not provide an object, it must set pObject to NULL and hResult to a failure flag.

Requirements

Requirement Value
Minimum supported client
Windows Vista [desktop apps only]
Minimum supported server
Windows Server 2003 [desktop apps only]
Header
Commctrl.h