Version 6.3.13 for Windows
 —  Dialog Component Reference  —

NGU-CLIENT-GET-DATA Subprogram

This document covers the following topics:


Natural Object Name

NGUCLGDA

Top of page

Description

You must use this subprogram in the event handler of a DDE-client event to fill the DDE-VIEW parameter data area. You must then ensure that your event handler code acts on the value of DDE-VIEW.MESSAGE. The possible values of DDE-VIEW.MESSAGE are:

DISCONNECT The server has terminated the conversation identified by DDE-VIEW.CONV-ID by unregistering the topic, or by exiting.
DATA The server has sent data for DDE-VIEW.CONV-ID and DDE-VIEW.ITEM. The data are contained in DDE-VIEW.DATA. The length of the data will be contained in DDE-VIEW.DATALEN.
NOTIFY The server has new data available for the conversation identified by DDE-VIEW.CONV-ID and DDE-VIEW.ITEM. The data are not sent at this point. You must request these data in your event handler. Only then the data will actually be received.
TIMEOUT No server message has been received during the timeout period.

When DDE-VIEW.MESSAGE has the value DISCONNECT, DATA, or NOTIFY, the fields DDE-VIEW.SERVICE and DDE-VIEW.TOPIC are also set appropriately.

Top of page

Parameters

Name/Data Type Explanation
1 DDE-VIEW Input/Output PDA for DDE subprograms.
2 SERVICE (A20) Service name.
2 TOPIC (A20) Topic name.
2 CONV-ID (I4) Conversation ID.
2 MESSAGE (A20) Message information.
2 ITEM (A20) Item of current conversation.
2 FORMAT (A20) Format of data to be sent.
2 TIMEOUT (I4) Time interval before the conversation is interrupted because there is no server message.
2 DATALEN (I2) Length of data.
2 DATA-ARRAY (A1/1:V)  
1 Max-Index (I2) Input Highest index of DATA-ARRAY; can be set to any I2 value.
1 Response (I4) Output Natural error (if applicable).

Top of page