Start Read SF

3270 5250 VT
Yes Yes Yes
The Start Read SF function allows a client application to read structured field data from the host application. After using this function, the client receives DATA messages notifying it that close requests occurred.
Note:
Before using this function, the client must call the Set Structured Field Service Condition function to pass the Query Reply data to the server.
The client sends the following command to begin a Read SF. 
PostMessage( hServerWnd,
             WM_DDE_ADVISE,
             hClientWnd,
             MAKELONG(hOptions, aSF) );
where:
hOptions Is a handle to a Windows global memory object, with the following 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 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 structured field data 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 structured field data. (It must be CF_DSPTEXT.)

aSF Identified structured field as the item.