TBN_RESTORE notification code

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.


    lpnmtb = (LPNMTBRESTORE) 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.


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.


Requirement Value
Minimum supported client
Windows Vista [desktop apps only]
Minimum supported server
Windows Server 2003 [desktop apps only]