NMN_GETAPPREGKEY

Other versions of this page are also available for the following:

• Windows Embedded CE 6.0 R3

8/28/2008

This notification message is sent to retrieve the application specific registry settings for New button menu items. This message is sent in the form of a WM_NOTIFY message.

The New button menu initializes new objects with data provided by the host application.

Syntax

NMN_GETAPPREGKEY
  wParam = (WPARAM) 0;
  lParam = (PNMNEWMENU) pnmnm;

Parameters

• wParam
  Reserved for future use; set to 0.

• pnmnm
  Pointer to an NMNEWMENU structure. The hMenu member is a handle to the New button menu.

Return Value

None.

Remarks

When your application is the foreground application, it receives WM_NOTIFY messages with NMN_GETAPPREGKEY notifications when the user chooses the New button menu. Your application must fill the szReg member of the NMNEWMENU structure with a null-terminated string of the following form:

HKLM\My Application\NewMenu

where the registry entry is:

HKEY_LOCAL_MACHINE\My Application\NewMenu\<GUID>
  @="Menu Text"

The shell enumerates all the GUID's under the provided key and adds menu entries for each.

When the user chooses a menu item, the shell first sends a WM_NOTIFY message with an NMN_INVOKECOMMAND notification to the application. If the application processes this message and returns TRUE, the shell does nothing further. If the application does not process this message, the shell calls CoCreateInstance to create an instance of the INewMenuItemServer COM object.

Requirements