A script-enabled browser is required for this page to function properly.

DDE.POKE

Description

Sends data to a DDE server application.

Syntax

DDE.POKE (ConvID, Item, Data, DataFormat, Timeout)

Parameters

Parameter

Type

Description

ConvID

PLS_INTEGER

DDE conversion identifier that is returned by DDE.INITIATE

Item

VARCHAR2

Data item name to which the data is to be sent

Data

VARCHAR2

Data buffer to send

DataFormat

PLS_INTEGER

Format of outgoing data

Timeout

PLS_INTEGER

Timeout duration in milliseconds

The value of Item depends on what values are supported by the DDE server application on the current conversation topic.

The Microsoft Windows Predefined Data Formats can be used for DataFormat. A user-defined format that is registered with DDE.GETFORMATNUM can also be used, provided the DDE server application recognizes the format. It is your responsibility to ensure that the DDE server application processes the specified data format.

Timeout specifies the maximum length of time, in milliseconds, that this routine waits for a response from the DDE server application. If you specify an invalid number, such as negative number, then the default value of 1000 ms is used. The duration of the timeout depends on machine configuration and the DDE server application.

DDE.POKE Examples

DECLARE
 ConvID PLS_INTEGER;
BEGIN
 /* Open a DDE conversation with Microsoft Excel for Windows on
  topic abc.xls. */
 ConvID = DDE.Initiate('EXCEL', 'C:/abc.xls');
 /* Send data "foo" to cell at row 2, column 2. */
 DDE.Poke(ConvID, 'R2C2', 'foo', DDE.CF_TEXT, 1000);
END;