Syntax 2 For commands over an opened channel

Description

Sends a command to a DDE server application when you have
already called OpenChannel and established a
warm link with the server.

Syntax

<span>ExecRemote</span> ( <span>command</span>, <span>handle</span> {, <span>windowhandle</span> } )

1	<span>ExecRemote</span> ( <span>command</span>, <span>handle</span> {, <span>windowhandle</span> } )

Argument	Description
command	A string whose value is the command you want a DDE server application to execute. The format of the command depends on the DDE application you want to execute the command.
handle	A long that identifies the channel to the DDE server application. The OpenChannel function returns handle when you call it to open a DDE channel.
windowhandle (optional)	The handle to the window that you want to act as the DDE client. Specify this parameter to control which window is acting as the DDE client when you have more than one open window. If you do not specify windowhandle, the active window acts as the DDE client.

Return Values

Integer. Returns 1 if it succeeds. If
an error occurs, ExecRemote returns a negative
integer. Possible values are:

-1 Link was
not started
-2 Request denied
-9 Handle is null

Usage

The DDE server application must already be running when you
call a DDE function. Use the Run function to
start the application if necessary.

The ExecRemote function allows you start
a cold link or use warm link between the PowerBuilder client application
and the DDE server application.

A cold link is a single DDE command and
is not associated with a DDE channel (see Syntax 1).

A warm link is associated with a DDE
channel. You establish a channel for the DDE conversation with OpenChannel before
sending commands with this syntax of ExecRemote.
A warm link is useful when you need to send several commands to
the DDE server application. Because the channel is open, ExecRemote does
not need to have Windows poll all running applications again. After
you have called ExecRemote or the related functions GetRemote or SetRemote,
and finished the work with the DDE server, call CloseChannel to
end the DDE conversation.

A DDE hot link, which enables automatic
updating of data in the PowerBuilder client application, involves
other functions. For more information, see the StartHotLink function.

Examples

This excerpt from a script asks the DDE channel to
Microsoft Excel to save the active spreadsheet as file REGION.XLS.
The OpenChannel function names the server application
and the topic, so ExecRemote only needs to specify
the channel handle. The script is associated with a button on a
window, whose handle is specified as the last argument of OpenChannel:

long handle

1	long handle

handle = OpenChannel("Excel", "REGION.XLS", &amp;

1	handle = OpenChannel("Excel", "REGION.XLS", &

        Handle(Parent))

1	Handle(Parent))

. . . // Some processing

1	. . . // Some processing

<span>ExecRemote</span>("[Save]", handle)

1	<span>ExecRemote</span>("[Save]", handle)

CloseChannel(handle, Handle(Parent))

1	CloseChannel(handle, Handle(Parent))

Connection Information

Syntax 2 For commands over an opened channel – PB Docs 150