5.79 RequestData Method

Description:	Acquires data from the DDE server. The maximum length that can be acquired at a time is 1024 bytes. When you acquire the data of 1024 bytes or more, you need to acquire it in 1024 byte chunks.
Used in controls:	DDE
Used in objects:	None.
Parameters:	No OLE data types. DDEData: A group item whose length is 1028 bytes.
Description of Parameters:	DDEData has the following elementary items. DataLengthS9(9) COMP-5 The length of the data in the buffer. If the total data length is longer than a single buffer can contain, use the DDEDataOffset property to track the data over multiple calls. DataAreaX(1024) The data from the DDE server.
Return value:	VT_I4 - ReturnValue S9(9) COMP-5 Zero or greater indicates normal completion. Negative indicates an error.
Example:	Place this code in the form's Opened method so that it establishes the DDE connection and executes only once: ENVIRONMENT DIVISION. DATA DIVISION. WORKING-STORAGE SECTION. PROCEDURE DIVISION. INVOKE CmDDE1 "Execute" USING "Excel c:\exceldde97.xls" POW-SWSHOWNORMAL RETURNING ReturnValue INVOKE CmDDE1 "OpenDDE" RETURNING ReturnValue The following code executes the RequestData method: ENVIRONMENT DIVISION. DATA DIVISION. WORKING-STORAGE SECTION. 01 DDE-Data. 03 Buffer-Len PIC S9(9) COMP-5. 03 DDE-Buffer PIC X(1024). 01 ReturnValue PIC S9(9) COMP-5. PROCEDURE DIVISION. COMPUTE Buffer-Length = LENGTH OF DDE-Buffer. MOVE Spaces TO DDE-Buffer INVOKE CmDDE1 "RequestData" USING DDE-Data RETURNING ReturnValue
Backward compatibility method name:	REQUESTDATA
Backward compatibility arguments:	A group item made up of the following elementary items. 1. S9(9) COMP-5 2. X(1024)