Personal Communications Response

Personal Communications receives the Start Menu Advise and returns an ACK message if it can start the function. Otherwise, a negative ACK message is returned to the client with one of the following return codes in the low-order byte of the wStatus field.


Return Code	Explanation
1	Menu Advise has been already started.
6	The specified format is not valid.
9	A system error occurred.

WM_DDE_ACK(wStatus,aSELECTMENU)

Once the menu item (added to the client application) is selected, the client receives DATA messages notifying it which menu item is selected:

WM_DDE_DATA(hData,aSELECTMENU)

where:

hData

Identifies a handle to a Windows global memory object containing:

typedef struct tagSELECTMENU
{
  unsigned char  data[(sizeof(DDEDATA)-1)];
  unsigned short uIDSelected; /* Command ID of the selected menu item
} SELECTMENU;
 
typedef union tagDDE_SELECTMENU
{
  DDEDATA     DDEdata;
  SELECTMENU  DDEmenu;
} DDE_SELECTMENU,*lpDDE_SELECTMENU;

The DATA messages continue until a Stop Menu Advise message is sent to Personal Communications.