NMN_GETPROPERTYBAG

The NMN_GETPROPERTYBAG notification message is sent to retrieve a Windows CE IPersistPropertyBag interface pointer that will be used to initialize the new object. When the application receives this notification, it should place a pointer to an IPersistPropertyBag interface into *(pnmnm->pppropbag) and call the Windows CE IUnknown::AddRef method on it. The Shell will use the properties in this property bag to initialize the new object and will use the Windows CE IUnknown::Release method to release the interface pointer when it is finished with it.

When using the New menu, it now has functionality in its API that enables "pushing" data into objects that were created; that is, it will be possible to initialize a new object with data that the application provides.

NMN_GETPROPERTYBAG
  res = (WPARAM) wParam;
  pnmnm = (PNMNEWMENU) lParam;

Parameters

  • res
    This parameter is reserved for future use; the value of this parameter must be set to 0.
  • pnmnm
    Reference to a NMNEWMENU structure.

Return Values

pnmnm->ppropbag is a pointer to the return value.

Requirements

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

See Also

IPersistPropertyBag:IPersist

IUnknown::AddRef

IUnknown::Release

NMNEWMENU

Send feedback on this topic to the authors.

© 2005 Microsoft Corporation. All rights reserved.