Share via


NMN_GETAPPREGKEY (Windows CE 5.0)

Send Feedback

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 Values

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

Pocket PC: Pocket PC 2000 and later
OS Versions: Windows CE 3.0 and later
Header: newmenu.h

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.