Put Data to Presentation Space

3270	5250	VT
Yes	Yes	Yes

The Put Data to Presentation Space function sends an ASCIIZ data string to be written into the host presentation space at the location specified by the calling parameter. The client sends the following message to the session to send the string.

PostMessage( hServerWnd,
             WM_DDE_POKE,
             hClientWnd,
             MAKELONG(hData, aEPS) );

where:

hData

Identifies a handle to a Windows global memory object that contains the string to be sent to the session. The global memory object contains the following structure:

typedef struct tagPutString
{
 unsigned unused:13;              // ** unused **
 unsigned fRelease:1;             // Session frees memory
 unsigned freserved:2;            // ** reserved **
 int      cfFormat;               // Always CF_DSPTEXT
 unsigned uPSStart;               // PS Position
 unsigned uEOFflag;               // EOF effective switch
 char     szStringData[1];        // String Data
} PUTSTRING, FAR *lpPUTSTRING;

These values are valid at the uEOFflag field:

WC_EFFECTEOF   0 // The string is truncated at EOF.
WC_UNEFFECTEOF 1 // The string is not truncated at EOF.

aEPS Identifies the presentation space atom as the item.