Start Close Intercept


3270	5250	VT
Yes	Yes	Yes

The Start Close Intercept function allows a client application to intercept close requests generated when a user selects the close option from the emulator session window. This function intercepts the close request and discards it until the Stop Close Intercept function is requested. After using this function, the client receives DATA messages notifying it that close requests occurred (CLOSE).

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

PostMessage( hServerWnd,
             WM_DDE_ADVISE,
             hClientWnd,
             Pack DDElParam(WM_DDE_ADVISE,
             (hOptions, aCLOSE) );

where:

hOptions

Is a handle to a Windows global memory object DDEADVISE structure.

If the value of fDeferUpd is 1, DDE Data messages will be 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 close requests until the server receives an ACK message from the client in response to any previous notification.

The cfFormat field specifies the format to send the close request. (Must be CF_DSPTEXT.)

aCLOSE

Identifies close intercept as the item.