Subroutine
Send unsolicited data to the server.
call DDEPokeString ( ConvID_IV, ItemName_SV, DataString_SV, DataLength_IV, Format_SV, Status_IV )
•ConvID_IV is an integer value representing the conversation ID assigned by the DDE DLL.
•ItemName_SV is a non-zero-length string value representing the item name. DataString_SV
•DataString_SV is the data string.
•DataLength_IV is an integer value representing the data length.
•Format_SV is a string value representing one of the formats listed below (defined in ESLDDE.INC), or any format string that references a text-based format that has been registered through a call to DDERegisterFormat. Normally, DDEFMT_TEXT is used for plain text. Formats defined in ESLDDE.INC are:
DDEFMT_TEXT
DDEFMT_DIF
DDEFMT_OEMTEXT
DDEFMT_SYLK
•Status_IV Status is 0.
Description
Called by the client. This subroutine sends unsolicited data to the server.
Upon receiving unsolicited data, the DDE protocol requires that the server respond as follows. The client should not attempt another DDE exchange for this conversation until the server has responded with one of these events.
Acknowledgment |
Subroutine Called |
Message |
Positive (Data is accepted) |
DDEAck with DDE_FACK status flag set |
WM_DDE_ACK with DDE_FACK status bit set |
Negative (Data is not accepted) |
DDEAck with DDE_FACK status flag not set |
WM_DDE_ACK with DDE_FACK status bit cleared |
Message
Posts a WM_DDE_POKE message to the server partner.
Example
response to PokeKey
# Get ConvID_IV
copy "itemname" to ItemName_SV
copy "poke data" to DataString_SV
copy (length of DataString_SV) to DataLength_IV
copy DDEFMT_TEXT to Format_SV
copy 0 to Status_IV
call DDEPokeString (ConvID_IV, ItemName_SV, DataString_SV,
DataLength_IV, Format_SV, Status_IV)
