Start Session Advise

3270	5250	VT
Yes	Yes	Yes

The Start Session Advise function establishes a link between the Personal Communications session and the client. This lets the client receive updates of the presentation space (PS), the operator information area (OIA), or the trim rectangle (TRIMRECT) when the data item is updated.

Note: If the client application needs conditional notification when the presentation space is updated, set an advise condition prior to invoking the advise function for the presentation space. See Set Session Advise Condition.

The client sends the following command to begin a session advise.

PostMessage( hServerWnd,
             WM_DDE_ADVISE,
             hClientWnd,
             MAKELONG(hOptions, aItem) );

where:

hOptions

Is a handle to a Windows global memory object. This is the structure:

typedef struct tagOPTIONS
{
 unsigned reserved:14;        // Reserved
 unsigned fDeferUpd:1;        // Send notification only
 unsigned fAckReq:1;          // Client will ACK all notices
 WORD     cfFormat;           // Clipboard format to use
}  OPTIONS, FAR *lpOPTIONS;

If the value of fDeferUpd is 1, DDE Data messages are sent to the client application with the hData set to NULL. The client must then issue a DDE REQUEST to request the data item.

If the value of fAckReq is 1, the server does not notify the client of further changes to the data item until the server receives an ACK message from the client in response to any previous update notification.

The cfFormat field specifies the format to send the data item when the item has been updated.

aItem Specifies the item of information being requested; in this case, the value can be PS, OIA, or TRIMRECT.