DDETerminate statement - MapBasic - 2023

MapInfo MapBasic Reference

Product type
Software
Portfolio
Locate
Product family
MapInfo
Product
MapInfo > MapBasic
Version
2023
Language
English
Product name
MapBasic
Title
MapInfo MapBasic Reference
First publish date
1985
Last updated
2023-09-12
Published on
2023-09-12T16:32:32.686312

Purpose

Closes a DDE conversation.

Syntax

DDETerminate channel

channel is an integer channel number returned by the DDEInitiate() function.

Description

The DDETerminate statement closes the DDE channel specified by the channel parameter.

The channel parameter must correspond to the channel number returned by the DDEInitiate() function call (which initiated the conversation). Once a DDE conversation has served its purpose and is no longer needed, the MapBasic program should terminate the conversation through the DDETerminate statement or the DDETerminate All statement.

Note: Multiple MapBasic applications can be in use simultaneously, and each application can open its own DDE channels. However, a given MapBasic application may only close the DDE channels which it opened. A MapBasic application may not close DDE channels which were opened by another MapBasic application.

Error Conditions

ERR_CMD_NOT_SUPPORTED (642) error generated if not running on Windows.

ERR_INVALID_CHANNEL (696) error generated if the specified channel number is invalid.

Example

DDETerminate i_chan_num 

See Also:

DDEInitiate() function, DDETerminate All statement