CePimCommand

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

The CePimCommand function creates a menu add-in on the Tools menu in the Contacts, Calendar, and Tasks applications. The dynamic-link library (DLL) that supports the menu add-in must define and expose this function.

Syntax

void CePimCommand(
  HWND hWnd,
  PIMTYPE ptData,
  UINT uDataCount,
  HANDLE * rghData,
  void pReserved
);

Parameters

  • hWnd
    [in] Application window handle.
  • ptData
    [in] The application calling this function. The following code example shows the definition for this enumeration.

    typedef enum tagPIMTYPE
    {
      PT_CALENDAR = 0,
      PT_TASKS,
      PT_CONTACT
    } PIMTYPE;
    

    The following code example shows that, in the case of the Microsoft Palm-sized PC 1.2 Color, the constants are ordered differently.

    typedef enum tagPIMTYPE
    {
      PT_CONTACT = 0,
      PT_CALENDAR,
      PT_TASKS
    } PIMTYPE;
    
  • uDataCount
    [in] Number of items that are in the array rghData.
  • rghData
    [in] An array of Windows Embedded CE object identifiers for the currently selected items in the Outlook Mobile application. You can use the object identifiers to get the selected items with the IPOutlookApp::GetItemFromOid method of the POOM IPOutlookApp object.
  • pReserved
    [in] A reserved parameter; currently NULL.

Remarks

To ensure that your Calendar menu extension does not fail during the call to IPOutlookApp::GetItemFromOid, use IUnknown::AddRef and IUnknown::Release so your extension objects are not inadvertently freed by another process.

The function CePimCommand has been deprecated and is no longer used for creating Outlook Mobile menu add-ins. Use the IContextMenu interface instead.

For more information on adding menus and new menu options to existing context-sensitive shortcut menus, see Developing Menu Components.

Requirements

Header pimstore.h
Library Pimstore.lib
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

Pocket Outlook Object Model Functions

Other Resources

Pocket Outlook Object Model Reference
Pocket Outlook Object Model (POOM)