5.DDE客户函数
5.1 CloseChannel ( handle {, windowhandle } )
//关闭先前用OpenChannel()函数打开的DDE服务器的通道。
Handle：long类型，通道句柄，指明要关闭的DDE通道
Windowhandle：long类型，可选项，指明用做DDE客户的PowerBuilder窗口的窗口句柄
返回值：Integer。函数执行成功时返回1，发生错误时返回下述值之一：-2通道不能被关闭；-3不能确认服务器；-9Handle参数的值为NULL
5.2 ExecRemote()
//功能请求DDE服务器应用程序执行命令。
语法1：直接向DDE服务器应用发送一条命令（冷连接方式）
ExecRemote ( command, applname, topicname )
Command：string类型，其值为希望DDE服务器应用执行的命令，命令格式和语法需要参看DDE服务器应用的文档
Applname：string类型，指定服务器应用的DDE名称
Topicname：string类型，指定命令中要使用的DDE应用的数据或实例返回值Integer。函数执行成功时返回1，发生错误时返回下述值之一：-1未启动连接；-2请求被拒绝；-3不能终止服务器如果任何参数的值为NULL，ExecRemote()函数返回NULL。
语法2：应用程序打开某个信道后向DDE服务器应用发送命令（热连接方式）
ExecRemote ( command, handle {, windowhandle } )
Command：string类型，其值为希望DDE服务器应用执行的命令，命令格式和语法需要参看DDE服务器应用的文档
Handle：long类型，指定使用的DDE通道句柄
Windowhandle：long类型，可选项，指明用做DDE客户的PowerBuilder窗口的窗口句柄。省略该参数时，当前应用中的活动窗口用做DDE客户
返回值：Integer。函数执行成功时返回1，发生错误时返回下述值之一：-1未启动连接；-2请求被拒绝；-9handle参数的值为NULL
5.3 GetDataDDE(string)
//从热连接服务器应用中获取数据，并将其保存到指定的字符串变量中。
String：string类型变量，用于保存接收到的数据
返回值：Integer。函数执行成功时返回1，发生错误时返回-1。如果任何参数的值为NULL，GetDataDDE()函数返回NULL。
5.4 GetDataDDEOrigin ( applstring, topicstring, itemstring )
//功能确定来自热连接DDE服务器应用的数据源，成功时将应用的DDE标识保存在参数指定的变量中。
Applstring：string类型变量，用于保存服务器应用的名称
Topicstring：string类型变量，用于保存主题（比如，在Excel中，主题可以是REGION.XLS）
Itemstring：string类型变量，用于保存数据项标识（比如，在Excel中，数据项标识可以是R1C2）
返回值：Integer。函数执行成功时返回1，发生错误时返回-1。如果任何参数的值为NULL，GetDataDDEOrigin()函数返回NULL。
5.5 GetRemote()
//请求服务器应用传送数据
语法一、请求DDE服务器应用提供数据并将数据保存在变量中，该格式不要求事先打开通道，适用于仅发出少数几个请求的情况。
GetRemote ( location, target, applname, topicname )
Location：string类型，指明要从DDE服务器的哪个位置返回数据。位置的表达方式由具体的DDE服务器决定
Target：string类型变量，用于保存返回的数据
Applname：string类型，指定DDE服务器应用的DDE名称topicname：string类型，指定命令中要使用的DDE应用的数据或实例
返回值：Integer。函数执行成功时返回1，发生错误时返回下述值之一：-1未启动连接-2请求被拒绝
语法二、请求DDE服务器应用提供数据并将数据保存在变量中，该格式适用于热连接的情况，即应用程序已经与服务器建立通道。
GetRemote ( location, target, handle {, windowhandle } )
Location：string类型，指明要从DDE服务器的哪个位置返回数据。位置的表达方式由具体的DDE服务器决定
Target：string类型变量，用于保存返回的数据
Handle：long类型，指定使用的DDE通道句柄
Windowhandle：long类型，可选项，指明用做DDE客户的PowerBuilder窗口的窗口句柄。省略该参数时，当前应用中的活动窗口用做DDE客户。使用handle()函数可以得到窗口句柄。
返回值：Integer。函数执行成功时返回1，发生错误时返回下述值之一：-1未启动连接；-2请求被拒绝；-9Handle参数的值为NULL
5.6 OpenChannel(applname, topicname {, windowhandle })
//功能打开连接DDE服务器的通道。
Applname：string类型，指定DDE服务器应用的DDE名称
Topicname：string类型，指定命令中要使用的DDE应用的数据或实例windowhandle：long类型，可选项，指明用做DDE客户的PowerBuilder窗口的窗口句柄。省略该参数时，当前应用中的活动窗口用做DDE客户
返回值：Long。函数执行成功时返回一个正数作为已打开通道的句柄，发生错误时返回下述值之一：-1打开失败-9句柄为NULL
5.7 RespondRemote(boolean)
//功能发送一条DDE消息，指示是否接受来自远程DDE应用的命令或数据。
Boolean:其值为boolean量的逻辑表达式，TRUE表示接收先前收到的命令或数据，FALSE表示不接收先前收到的命令或数据
返回值：Integer。函数执行成功时返回1，发生错误时返回-1。如果boolean参数的值为NULL，RespondRemote()函数返回NULL。
5.8 SetRemote()
//功能请求服务器应用把指定项设置为指定值。
语法一、请求DDE服务器应用接收保存在指定位置的数据，该格式不要求事先打开通道，适用于仅发出少数几个请求的情况。
SetRemote ( location, value, applname, topicname )
Location：string类型，指明要DDE服务器的哪一部分接收数据。位置的表达方式由具体的DDE服务器决定
value：string类型变量，指定发送给DDE服务器的数据
applname：string类型，指定DDE服务器应用的DDE名称
topicname：string类型，指定要接收数据的DDE应用的数据或实例
返回值Integer。函数执行成功时返回1，发生错误时返回下述值之一：-1未启动连接-2请求被拒绝
语法二、请求DDE服务器应用接收保存在指定位置的数据，该格式适用于热连接的情况，即应用程序已经与服务器建立通道。
SetRemote ( location, value, handle {, windowhandle } )
Location：string类型，指明要DDE服务器的哪一部分接收数据。位置的表达方式由具体的DDE服务器决定
Value：string类型变量，指定发送给DDE服务器的数据
Handle：long类型，指定使用的DDE通道句柄
Windowhandle：long类型，可选项，指明用做DDE客户的PowerBuilder窗口的窗口句柄。省略该参数时，当前应用中的活动窗口用做DDE客户
返回值：Integer。函数执行成功时返回1，发生错误时返回下述值之一：-1未启动连接；-2请求被拒绝-9Handle参数的值为NULL
5.9 StartHotLink(location, applname, topic)
//建立与DDE服务器应用的热连接，热连接建立之后，DDE服务器端相关数据的变化会立即触发PowerBuilder应用相关窗口的HotLinkAlarm事件。
Location：string类型，指明DDE服务器哪一部分数据变化时触发窗口的HotLinkAlarm事件。位置的表达方式由具体的DDE服务器决定
applname：string类型，指定DDE服务器应用的DDE名称
topicname：string类型，指定数据改变将触发窗口的HotLinkAlarm事件的DDE应用的数据或实例
返回值：Integer。函数执行成功时返回1，发生错误时返回下述值之一：-1无指定服务器-2请求被拒绝如果任何参数的值为NULL，StartHotLink()函数返回NULL。
5.10 StopHotLink()
功能关闭与DDE服务器应用的热连接。
语法StopHotLink ( location, applname, topic )
参数location：string类型，指明要终止DDE服务器哪一部分的热连接。位置的表达方式由具体的DDE服务器决定applname：string类型，指定DDE服务器应用的DDE名称topicname：string类型，指定要终止热连接的DDE应用的数据或实例返回值Integer。函数执行成功时返回1，发生错误时返回下述值之一：-1连接未曾启动；-2请求被拒绝；-3不能终止服务器如果任何参数的值为NULL，StopHotLink()函数返回NULL。
6.DDE服务器函数
6.1 GetCommandDDE(string)
//功能得到DDE客户应用发送的命令。
String：string类型的变量，用于保存DDE客户应用发送的命令
返回值：Integer。函数执行成功时返回1，发生错误时返回-1。如果string参数的值为NULL， GetCommandDDE()函数返回NULL。用法当DDE客户应用向DDE服务器应用发送一条命令时，这个动作将触发DDE服务器应用活动窗口的RemoteExec事件，在这个事件的事件处理程序中，可以使用GetCommandDDE()函数得到DDE客户应用发送的命令。
6.2 GetCommandDDEOrigin(applstring)
//功能确定哪一个DDE客户应用向服务器发送了命令。
Applstring：string变量，用于保存发送命令的DDE客户应用的名称
返回值：Integer。函数执行成功时返回1，发生错误时返回-1。如果applstring参数的值为 NULL，GetCommandDDEOrigin()函数返回NULL。
6.3 GetDataDDE(string)
//功能得到DDE客户应用发送的数据。
String：string类型变量，用于保存接收到的数据
返回值：Integer。函数执行成功时返回1，发生错误时返回-1。如果任何参数的值为NULL， GetDataDDE()函数返回NULL。
6.4 GetDataDDEOrigin ( applstring, topicstring, itemstring )
//功能确定哪个DDE客户应用发送了数据。
Applstring：string类型变量，用于保存客户应用的名称
Topicstring：string类型变量，用于保存主题（比如，在Excel中，主题可以是REGION.XLS）
Itemstring：string类型变量，用于保存数据项标识（比如，在Excel中，数据项标识可能是R1C2）
返回值：Integer。函数执行成功时返回1，发生错误时返回-1。如果任何参数的值为NULL，GetDataDDEOrigin()函数返回NULL。
6.5 RespondRemote(boolean)
//功能向客户端应用指明最近的命令或数据是否已经接收。
Boolean：其值为boolean量的逻辑表达式，TRUE表示接收先前收到的命令或数据，FALSE表示不接收先前收到的命令或数据
返回值：Integer。函数执行成功时返回1，发生错误时返回-1。如果boolean参数的值为NULL，RespondRemote()函数返回NULL。
6.6 SetDataDDE ( string {, applname, topic, item } )
//功能向DDE客户应用发送数据。
String：指定要发送到DDE客户应用的数据
Applname：string类型，可选项，指定接收数据的客户应用的DDE名称
Topic：string类型，可选项，指定基础数据组
Item：string类型，可选项，指定基础数据组中的数据项
返回值：Integer。函数执行成功时返回1，发生错误时返回下述值之一：-1函数调用的环境不对-2数据未被接收如果任何参数的值为NULL，SetDataDDE()函数返回NULL。
6.7 StartServerDDE ( { windowname, } applname, topic {, item } )
//功能将当前应用设置为DDE服务器。
Windowname：可选项，指定服务器窗口名，缺省值为当前窗口
Applname：当前应用的DDE名称
Topic：string类型，指定DDE客户应用能够引用的基本数据组
Item：由逗号（,）分隔的一个或多个字符串，指定服务器应用支持的数据项
返回值：Integer。函数执行成功时返回1，发生错误时返回-1，表示当前应用已经设置为DDE服务器。如果任何参数的值为NULL，StartServerDDE()函数返回NULL。
6.8 StopServerDDE ( { windowname, } applname, topic )
//功能停止当前应用的DDE服务器功能。执行该函数后，发给该应用的任何DDE客户应用请求都将失败。
Windowname：可选项，指定要关闭服务器功能的服务器窗口名，缺省值为当前窗口，如果当前应用有多个服务器窗口，那么必须指定该参数
Applname：当前应用的DDE名称
Topic：string类型，应该与StartServerDDE()中对应参数相同
返回值：Integer。函数执行成功时返回1，发生错误时返回-1，表示当前应用未曾作为DDE服务器启动。如果任何参数的值为NULL，StopServerDDE()函数返回NULL。
整理时间：2019-11-19 09:51:00
时间：2019-11-19 10:00:00