Edit

Share via

TBN_RESTORE notification code

  • Article

Notifies a toolbar's parent window that a toolbar is in the process of being restored. This notification code is sent in the form of a WM_NOTIFY message.

TBN_RESTORE 

    lpnmtb = (LPNMTBRESTORE) lParam;

Parameters

lParam

Pointer to an NMTBRESTORE structure.

Return value

The application should return zero in response to the first TBN_RESTORE notification code received at the start of the restore process to continue restoring the button information. If the application returns a nonzero value, the restore process is canceled.

Remarks

The application will receive this notification code once at the start of the restore process and once for each button. This notification code gives you an opportunity to extract the information from the data stream that you saved previously. If you haven't saved any information, ignore the notification code. See Toolbar Customization for a more detailed discussion of how to handle TBN_RESTORE.

Requirements

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