XTYP_POKE

A client uses the XTYP_POKE transaction to send unsolicited data to the server. A DDE server callback function, DdeCallback, receives this transaction when a client specifies XTYP_POKE in DdeClientTransaction function.

HDDEDATA CALLBACK DdeCallback(
  UINT uType,     // XTYP_POKE
  UINT uFmt,      // clipboard data format
  HCONV hconv,    // handle to the conversation
  HSZ hsz1,       // handle to a string
  HSZ hsz2,       // handle to a string
  HDDEDATA hdata, // handle to a global memory object
  DWORD dwData1,  // transaction-specific data
  DWORD dwData2   // transaction-specific data
);

Parameters

uType

Specifies the transaction type.

uFmt

Specifies the format of the data sent from the server.

hconv

Handle to the conversation.

hsz1

Handle to the topic name.

hsz2

Handle to the item name.

hdata

Handle to the data that the client is sending to the server.

dwData1

Not used.

dwData2

Not used.

Return Values

A server callback function should return the DDE_FACK flag if it processes this transaction, the DDE_FBUSY flag if it is too busy to process this transaction, or the DDE_FNOTPROCESSED flag if it rejects this transaction.

Remarks

This transaction is filtered if the server application specified the CBF_FAIL_POKES flag in the DdeInitialize function.

Requirements

  Windows NT/2000: Requires Windows NT 3.1 or later.
  Windows 95/98: Requires Windows 95 or later.
  Header: Declared in Ddeml.h; include Windows.h.

See Also

Dynamic Data Exchange Management Library Overview, Dynamic Data Exchange Management Transactions, DdeClientTransaction, DdeInitialize