RespondRemote

Description

Sends a DDE message indicating whether the command or data received from a remote DDE application was acceptable.

Syntax

RespondRemote ( boolean )

Argument

Description

boolean

A boolean expression. true indicates that the previously received command or data was acceptable. false indicates that it was not.


Return value

Integer. Returns 1 if it succeeds and -1 if an error occurs (for example, the function was called in wrong context). If boolean is null, RespondRemote returns null.

Usage

You can use RespondRemote when the PowerBuilder application is the DDE server or DDE client application.

You usually call RespondRemote after these functions:

GetCommandDDE

GetCommandDDEOrigin

GetDataDDE

GetDataDDEOrigin

For more information about PowerBuilder as a client, see OpenChannel and ExecRemote. For more information about PowerBuilder as a server, see StartServerDDE.

Examples

In a script for the HotLinkAlarm event, these statements tell a remote application named Gateway that its data was successfully received:

String Applname, Topic, Item, Value
GetDataDDEOrigin(Applname, Topic, Item)
IF Applname = "Gateway" THEN
    IF GetDataDDE(Value) = 1 THEN
      RespondRemote(TRUE)
    END IF
END IF

See also

GetCommandDDE

GetCommandDDEOrigin

GetDataDDE

GetDataDDEOrigin