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,
             PackDDElParam(WM_DDE_POKE,
             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 char  poke[(sizeof(DDEPOKE)-1)];
  unsigned short uPSStart;                       /* PS Position
  unsigned short uEOFflag;                       /* EOF effective switch
  unsigned char  szStringData[1];                 /* String Data
} PUTSTRING;

typedef union tagDDE_PUTSTRING
{
  DDEPOKE    DDEpoke;
  PUTSTRING  DDEputstring;
} DDE_PUTSTRING, *lpDDE_PUTSTRING;

These values are valid at the uEOFflag field:

 PCS_UNEFFECTEOF 0        /* The string is not truncated at EOF.
 PCS_EFFECTEOF   1        /* The string is truncated at EOF.

aEPS

Identifies the presentation space atom as the item.