Dynamic Data Exchange Management Library Dynamic Data Exchange (DDE) is a form of interprocess communication that uses shared memory to exchange data between applications. Applications can use DDE for one-time data transfers and for ongoing exchanges and updating of data.

Overviews

About the DDEML

This topic discusses dynamic data exchange.

Basic Concepts

This topic discusses key concepts concerning dynamic data exchange.

Conversation Management

This topic discusses conversations between a client and a server.

Data Management

This topic discusses how memory objects pass data from one application to another.

Monitoring Applications

This topic discusses how elements of the Dynamic Data Exchange Management Library can be used to create an application that monitors dynamic data exchange activity in the system.

Name Service

This topic discusses how the Dynamic Data Exchange Management Library makes it possible for a server application to register the service names that it supports.

Transaction Management

This topic discusses how a client can send transactions to obtain data and services from the server.

Functions

DdeAbandonTransaction

The DdeAbandonTransaction function abandons the specified asynchronous transaction and releases all resources associated with the transaction.

DdeAccessData

The DdeAccessData function provides access to the data in the specified DDE object. An application must call the DdeUnaccessData function when it has finished accessing the data in the object.

DdeAddData

The DdeAddData function adds data to the specified DDE object. An application can add data starting at any offset from the beginning of the object. If new data overlaps data already in the object, the new data overwrites the old data in the bytes where the overlap occurs. The contents of locations in the object that have not been written to are undefined.

DdeCallback

The DdeCallback function is an application-defined callback function used with the Dynamic Data Exchange Management Library (DDEML) functions. It processes DDE transactions. The PFNCALLBACK type defines a pointer to this callback function. DdeCallback is a placeholder for the application-defined function name.

DdeClientTransaction

The DdeClientTransaction function begins a data transaction between a client and a server. Only a DDE client application can call this function, and the application can use it only after establishing a conversation with the server.

DdeCmpStringHandles

The DdeCmpStringHandles function compares the values of two string handles. The value of a string handle is not related to the case of the associated string.

DdeConnect

The DdeConnect function establishes a conversation with a server application that supports the specified service name and topic name pair. If more than one such server exists, the system selects only one.

DdeConnectList

The DdeConnectList function establishes a conversation with all server applications that support the specified service name and topic name pair. An application can also use this function to obtain a list of conversation handles by passing the function an existing conversation handle. The Dynamic Data Exchange Management Library removes the handles of any terminated conversations from the conversation list. The resulting conversation list contains the handles of all currently established conversations that support the specified service name and topic name.

DdeCreateDataHandle

The DdeCreateDataHandle function creates a DDE object and fills the object with data from the specified buffer. A DDE application uses this function during transactions that involve passing data to the partner application.

DdeCreateStringHandle

The DdeCreateStringHandle function creates a handle that identifies the specified string. A DDE client or server application can pass the string handle as a parameter to other Dynamic Data Exchange Management Library (DDEML) functions.

DdeDisconnect

The DdeDisconnect function terminates a conversation started by either the DdeConnect or DdeConnectList function and invalidates the specified conversation handle.

DdeDisconnectList

The DdeDisconnectList function destroys the specified conversation list and terminates all conversations associated with the list.

DdeEnableCallback

The DdeEnableCallback function enables or disables transactions for a specific conversation or for all conversations currently established by the calling application.

DdeFreeDataHandle

The DdeFreeDataHandle function frees a DDE object and deletes the data handle associated with the object.

DdeFreeStringHandle

The DdeFreeStringHandle function frees a string handle in the calling application.

DdeGetData

The DdeGetData function copies data from the specified DDE object to the specified local buffer.

DdeGetLastError

The DdeGetLastError function retrieves the most recent error code set by the failure of a DDEML function and resets the error code to DMLERR_NO_ERROR.

DdeImpersonateClient

The DdeImpersonateClient function impersonates a DDE client application in a DDE client conversation.

DdeInitialize

The DdeInitialize function registers an application with the Dynamic Data Exchange Management Library (DDEML). An application must call this function before calling any other DDEML function.

DdeKeepStringHandle

The DdeKeepStringHandle function increments the usage count associated with the specified handle. This function enables an application to save a string handle passed to the application's DDE callback function. Otherwise, a string handle passed to the callback function is deleted when the callback function returns. This function should also be used to keep a copy of a string handle referenced by the CONVINFO structure returned by the DdeQueryConvInfo function.

DdeNameService

The DdeNameService function registers or unregisters the service names a DDE server supports. This function causes the system to send XTYP_REGISTER or XTYP_UNREGISTER transactions to other running Dynamic Data Exchange Management Library (DDEML) client applications.

DdePostAdvise

The DdePostAdvise function causes the system to send an XTYP_ADVREQ transaction to the calling (server) application's DDE callback function for each client with an active advise loop on the specified topic and item. A server application should call this function whenever the data associated with the topic name or item name pair changes.

DdeQueryConvInfo

The DdeQueryConvInfo function retrieves information about a DDE transaction and about the conversation in which the transaction takes place.

DdeQueryNextServer

The DdeQueryNextServer function retrieves the next conversation handle in the specified conversation list.

DdeQueryString

The DdeQueryString function copies text associated with a string handle into a buffer.

DdeReconnect

The DdeReconnect function enables a client Dynamic Data Exchange Management Library (DDEML) application to attempt to reestablish a conversation with a service that has terminated a conversation with the client. When the conversation is reestablished, the DDEML attempts to reestablish any preexisting advise loops.

DdeSetUserHandle

The DdeSetUserHandle function associates an application-defined value with a conversation handle or a transaction identifier. This is useful for simplifying the processing of asynchronous transactions. An application can use the DdeQueryConvInfo function to retrieve this value.

DdeUnaccessData

The DdeUnaccessData function unaccesses a DDE object. An application must call this function after it has finished accessing the object.

DdeUninitialize

The DdeUninitialize function frees all DDEML resources associated with the calling application.

Transactions

XTYP_ADVDATA

The XTYP_ADVDATA transaction informs the client that the value of the data item has changed. The DDE client callback function, DdeCallback, receives this transaction after establishing an advise loop with a server.

XTYP_ADVREQ

The XTYP_ADVREQ transaction informs the server that an advise transaction is outstanding on the specified topic name and item name pair and that data corresponding to the topic name and item name pair has changed. The system sends this transaction to the DDE callback function, DdeCallback, after the server calls the DdePostAdvise function.

XTYP_ADVSTART

A client uses the XTYP_ADVSTART transaction to establish an advise loop with a server. A DDE server callback function, DdeCallback, receives this transaction when a client specifies XTYP_ADVSTART as the wType parameter of the DdeClientTransaction function.

XTYP_ADVSTOP

A client uses the XTYP_ADVSTOP transaction to end an advise loop with a server. A DDE server callback function, DdeCallback, receives this transaction when a client specifies XTYP_ADVSTOP in the DdeClientTransaction function.

XTYP_CONNECT

A client uses the XTYP_CONNECT transaction to establish a conversation. A DDE server callback function, DdeCallback, receives this transaction when a client specifies a service name that the server supports (and a topic name that is not NULL) in a call to the DdeConnect function.

XTYP_CONNECT_CONFIRM

A DDE server callback function, DdeCallback, receives the XTYP_CONNECT_CONFIRM transaction to confirm that a conversation has been established with a client and to provide the server with the conversation handle. The system sends this transaction as a result of a previous XTYP_CONNECT or XTYP_WILDCONNECT transaction.

XTYP_DISCONNECT

An application's DDE callback function, DdeCallback, receives the XTYP_DISCONNECT transaction when the application's partner in a conversation uses the DdeDisconnect function to terminate the conversation.

XTYP_ERROR

A DDE callback function, DdeCallback, receives the XTYP_ERROR transaction when a critical error occurs.

XTYP_EXECUTE

A client uses the XTYP_EXECUTE transaction to send a command string to the server. A DDE server callback function, DdeCallback, receives this transaction when a client specifies XTYP_EXECUTE in the DdeClientTransaction function.

XTYP_MONITOR

A DDE debugger's DDE callback function, DdeCallback, receives the XTYP_MONITOR transaction whenever a DDE event occurs in the system. To receive this transaction, an application must specify the APPCLASS_MONITOR value when it calls the DdeInitialize function.

XTYP_POKE

A client uses the XTYP_POKE transaction to send unsolicited data to the server. A DDE server callback function, DdeCallback, receives this transaction when a client specifies XTYP_POKE in the DdeClientTransaction function.

XTYP_REGISTER

A DDE callback function, DdeCallback, receives the XTYP_REGISTER transaction type whenever a DDEML server application uses the DdeNameService function to register a service name, or whenever a non-DDEML application that supports the System topic is started.

XTYP_REQUEST

A client uses the XTYP_REQUEST transaction to request data from a server. A DDE server callback function, DdeCallback, receives this transaction when a client specifies XTYP_REQUEST in the DdeClientTransaction function.

XTYP_UNREGISTER

A DDE callback function, DdeCallback, receives the XTYP_UNREGISTER transaction whenever a DDEML server application uses the DdeNameService function to unregister a service name, or whenever a non-DDEML application that supports the System topic is terminated.

XTYP_WILDCONNECT

The XTYP_WILDCONNECT transaction allows a client to establish a conversation on each of the server's service name and topic name pairs that match the specified service name and topic name. A DDE server callback function, DdeCallback, receives this transaction when a client specifies a NULL service name, a NULL topic name, or both in a call to the DdeConnect or DdeConnectList function.

XTYP_XACT_COMPLETE

A DDE client callback function, DdeCallback, receives the XTYP_XACT_COMPLETE transaction when an asynchronous transaction, initiated by a call to the DdeClientTransaction function, has completed.

Structures

CONVCONTEXT

The CONVCONTEXT structure contains information supplied by a DDE client application. The information is useful for specialized or cross-language DDE conversations.

CONVINFO

The CONVINFO structure contains information about a DDE conversation.

DDEML_MSG_HOOK_DATA

The DDEML_MSG_HOOK_DATA structure contains information about a DDE message, and provides read access to the data referenced by the message. This structure is intended to be used by a DDEML monitoring application.

MONCBSTRUCT

The MONCBSTRUCT structure contains information about the current DDE transaction. A DDE debugging application can use this structure when monitoring transactions that the system passes to the DDE callback functions of other applications.

MONCONVSTRUCT

The MONCONVSTRUCT structure contains information about a DDE conversation. A DDE monitoring application can use this structure to obtain information about a conversation that has been established or has terminated.

MONERRSTRUCT

The MONERRSTRUCT structure contains information about the current DDE error. A DDE monitoring application can use this structure to monitor errors returned by DDE Management Library functions.

MONHSZSTRUCT

The MONHSZSTRUCT structure contains information about a DDE string handle. A DDE monitoring application can use this structure when monitoring the activity of the string manager component of the DDE Management Library.

MONLINKSTRUCT

The MONLINKSTRUCT structure contains information about a DDE advise loop. A DDE monitoring application can use this structure to obtain information about an advise loop that has started or ended.

MONMSGSTRUCT

The MONMSGSTRUCT structure contains information about a DDE message. A DDE monitoring application can use this structure to obtain information about a DDE message that was sent or posted.