Set Session Advise Condition


3270	5250	VT
Yes	Yes	Yes

This function sets the condition for the DDE_ADVISE of the Start Session Advise function. The client can specify a search string and a region of the screen. When the advise condition is met, the server notifies the client of the condition according to the options specified by the Start Session Advise function.

Note:

The client must specify the Set Session Advise Condition function before invoking Start Session Advise. If the advise condition is set after the Start Session Advise function is started, the advise condition will be ignored and the client will receive a negative ACK message. See Start Session Advise for more information about starting the advise.

The client sends the following message to set the advise condition.

PostMessage( hServerWnd,
             WM_DDE_POKE,
             hClientWnd,
             PackDDElParam(WM_DDE_POKE,
             (hData, aPSCOND) );

where:

hData

Identifies a handle to a Windows global memory object containing:

typedef struct tagSEARCHDATA
{
  unsigned char  poke[(sizeof(DDEPOKE)-1)];
  unsigned short uPSStart;                  /* PS Position of string
  unsigned short uPSLength;                 /* Length of String
  BOOL           bCaseSensitive;            /* Case Sensitive TRUE=YES
  unsigned char  SearchString[1]; /* Search String
} SEARCHDATA;
 
typedef union tagDDE_SEARCHDATA
{
  DDEPOKE     DDEpoke;
  SEARCHDATA  DDEcond;
} DDE_SEARCHDATA, *lpDDE_SEARCHDATA;

aPSCOND

Identifies the item for the Set Session Advise Condition function.