GetDataDDE (Obsolete)

Description

Obtains data sent from another DDE application and stores it in the specified string variable. PowerBuilder can use GetDataDDE when acting as a DDE client or a DDE server application.

Syntax

GetDataDDE ( string )

Argument

Description

string

A string variable in which GetDataDDE will put the data received from a remote DDE application


Return value

Integer.

Returns 1 if it succeeds and -1 if an error occurs (such as the function was called in the wrong context). If string is null, GetDataDDE returns null.

Usage

GetDataDDE is usually called in the window-level script for a RemoteSend event when your application is a DDE server or HotLinkAlarm event when your application is a DDE client.

Examples

Assuming that your PowerBuilder DDE client application has established a hot link with row 7, column 15 of an Excel spreadsheet, and that the value in that row and column address has changed from red to green (which triggers the HotLinkAlarm event in your application), this script for the HotLinkAlarm event calls GetDataDDE to store the new value in the variable Str20:

// In the script for a HotLinkAlarm event
string Str20
GetDataDDE(Str20)

See also

GetDataDDEOrigin

OpenChannel

StartServerDDE

StopServerDDE