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,
             MAKELONG(hData, aPSCOND) );
where:
hData Identifies a handle to a Windows global memory object containing: 
typedef struct tagSEARCHDATA
{
 unsigned   unused:13,             //
 unsigned   fRelease:1,            //
 unsigned   fReserved:2;           //
 int        cfFormat;              // Always CF_DSPTEXT
 WORD       uPSStart;              // PS Position of string
 WORD       uPSLength              // Length of String
 BOOL       bCaseSensitive;        // Case Sensitive TRUE=YES
 char       SearchString[1];       // Search String
} SEARCHDATA, FAR *lpSEARCHDATA;
aPSCOND Identifies the item for the Set Session Advise Condition function.