dynamische Daten Exchange Management Library

dynamische Daten Exchange (DDE) ist eine Form der prozessübergreifenden Kommunikation, bei der freigegebener Arbeitsspeicher zum Austauschen von Daten zwischen Anwendungen verwendet wird. Anwendungen können DDE für einmalige Datenübertragungen sowie für den fortlaufenden Austausch und die Aktualisierung von Daten verwenden.

In diesem Abschnitt

Name BESCHREIBUNG
Informationen zur DDEML Erläutert den dynamischen Datenaustausch.
Grundlegende Konzepte Erläutert die wichtigsten Konzepte für den dynamischen Datenaustausch.
Konversationsverwaltung Erläutert Konversationen zwischen einem Client und einem Server.
Datenverwaltung Erläutert, wie Speicherobjekte Daten von einer Anwendung an eine andere übergeben.
Überwachen von Anwendungen Erläutert, wie Elemente der dynamische Daten Exchange Management Library verwendet werden können, um eine Anwendung zu erstellen, die dynamische Datenaustauschaktivitäten im System überwacht.
Name Service Erläutert, wie dynamische Daten Exchange-Verwaltungsbibliothek es einer Serveranwendung ermöglicht, die von ihr unterstützten Dienstnamen zu registrieren.
Transaktionsverwaltung Erläutert, wie ein Client Transaktionen senden kann, um Daten und Dienste vom Server zu erhalten.
DDEML-Referenz Enthält die API-Referenz.

DDEML-Funktionen

Name BESCHREIBUNG
DdeAbbignTransaction Gibt die angegebene asynchrone Transaktion ab und gibt alle ressourcen frei, die der Transaktion zugeordnet sind.
DdeAccessData Ermöglicht den Zugriff auf die Daten im angegebenen DDE-Objekt. Eine Anwendung muss die DdeUnaccessData-Funktion aufrufen, wenn sie den Zugriff auf die Daten im -Objekt abgeschlossen hat.
DdeAddData Fügt dem angegebenen DDE-Objekt Daten hinzu. Eine Anwendung kann Daten ab einem beliebigen Offset vom Anfang des Objekts hinzufügen. Wenn sich neue Daten bereits im -Objekt überschneiden, überschreiben die neuen Daten die alten Daten in den Bytes, in denen die Überlappung auftritt. Der Inhalt von Speicherorten im -Objekt, in die nicht geschrieben wurde, ist nicht definiert.
DdeCallback Eine anwendungsdefinierte Rückruffunktion, die mit den DDEML-Funktionen (dynamische Daten Exchange Management Library) verwendet wird. DDE-Transaktionen werden verarbeitet. Der PFNCALLBACK-Typ definiert einen Zeiger auf diese Rückruffunktion. DdeCallback ist ein Platzhalter für den anwendungsdefinierten Funktionsnamen.
DdeClientTransaction Startet eine Datentransaktion zwischen einem Client und einem Server. Nur eine DDE-Clientanwendung kann diese Funktion aufrufen, und die Anwendung kann sie nur verwenden, nachdem eine Konversation mit dem Server hergestellt wurde.
DdeCmpStringHandles Vergleicht die Werte von zwei Zeichenfolgenhandles. Der Wert eines Zeichenfolgenhandpunkts bezieht sich nicht auf den Fall der zugeordneten Zeichenfolge.
DdeConnect Richtet eine Konversation mit einer Serveranwendung ein, die das angegebene Dienstnamen- und Themennamenpaar unterstützt. Wenn mehr als ein solcher Server vorhanden ist, wählt das System nur einen server aus.
DdeConnectList Richtet eine Konversation mit allen Serveranwendungen ein, die das angegebene Dienstnamen- und Themennamenpaar unterstützen. Eine Anwendung kann diese Funktion auch verwenden, um eine Liste von Konversationshandles zu erhalten, indem sie der Funktion ein vorhandenes Konversationshandles über gibt.
DdeCreateDataHandle Erstellt ein DDE-Objekt und füllt das Objekt mit Daten aus dem angegebenen Puffer. Eine DDE-Anwendung verwendet diese Funktion während Transaktionen, bei denen Daten an die Partneranwendung übergeben werden.
DdeCreateStringHandle Erstellt ein Handle, das die angegebene Zeichenfolge identifiziert. Eine DDE-Client- oder -Serveranwendung kann das Zeichenfolgenhandle als Parameter an andere DDEML-Funktionen (dynamische Daten Exchange Management Library) übergeben.
DdeDisconnect Beendet eine Konversation, die entweder von der DdeConnect- oder DdeConnectList-Funktion gestartet wurde, und erklärt das angegebene Konversationshand handle für ungültig.
DdeDisconnectList Zerstört die angegebene Konversationsliste und beendet alle Konversationen, die der Liste zugeordnet sind.
DdeEnableCallback Aktiviert oder deaktiviert Transaktionen für eine bestimmte Konversation oder für alle Konversationen, die derzeit von der aufrufenden Anwendung eingerichtet werden.
DdeFreeDataHandle Berechnet ein DDE-Objekt und löscht das dem Objekt zugeordnete Datenhand handle.
DdeFreeStringHandle Gibt ein Zeichenfolgenhand handle in der aufrufenden Anwendung frei.
DdeGetData Kopiert Daten aus dem angegebenen DDE-Objekt in den angegebenen lokalen Puffer.
DdeGetLastError Ruft den letzten Fehlercode ab, der durch den Ausfall einer DDEML-Funktion festgelegt wurde, und setzt den Fehlercode auf DMLERR _ NO _ ERROR zurück.
DdeImpersonateClient Imitiert die Identität einer DDE-Clientanwendung in einer DDE-Client-Konversation.
DdeInitialize Registriert eine Anwendung bei der dynamische Daten Exchange Management Library (DDEML). Eine Anwendung muss diese Funktion aufrufen, bevor sie eine andere DDEML-Funktion aufruft.
DdeKeepStringHandle Erhöht die Dem angegebenen Handle zugeordnete Nutzungsanzahl. Mit dieser Funktion kann eine Anwendung ein Zeichenfolgenhand handle speichern, das an die DDE-Rückruffunktion der Anwendung übergeben wird. Andernfalls wird ein an die Rückruffunktion übergebenes Zeichenfolgenhand handle gelöscht, wenn die Rückruffunktion zurückgegeben wird. Diese Funktion sollte auch verwendet werden, um eine Kopie eines Zeichenfolgenhandpunkts zu behalten, auf das von der CONVINFO-Struktur verwiesen wird, die von der DdeQueryConvInfo-Funktion zurückgegeben wird.
DdeNameService Registriert oder setzt die Registrierung der Dienstnamen auf, die von einem DDE-Server unterstützt werden. Diese Funktion bewirkt, dass das System XTYP _ REGISTER- oder XTYP _ UNREGISTER-Transaktionen an andere ausgeführte dynamische Daten Exchange Management Library (DDEML)-Clientanwendungen sendet.
DdePostAdvise Sendet eine XTYP _ ADZUGRIFFQ-Transaktion an die DDE-Rückruffunktion der aufrufenden (Server)-Anwendung für jeden Client mit einer aktiven Advise-Schleife für das angegebene Thema und Element. Eine Serveranwendung sollte diese Funktion aufrufen, wenn sich die dem Themennamen oder Elementnamenpaar zugeordneten Daten ändern.
DdeQueryConvInfo Ruft Informationen zu einer DDE-Transaktion und zur Konversation ab, in der die Transaktion stattfindet.
DdeQueryNextServer Ruft das nächste Konversationshand handle in der angegebenen Konversationsliste ab.
DdeQueryString Kopiert text, der einem Zeichenfolgenhand handle zugeordnet ist, in einen Puffer.
DdeReconnect Ermöglicht einer DDEML-Anwendung (Client dynamische Daten Exchange Management Library), eine Konversation mit einem Dienst wiederhergestellt zu haben, der eine Konversation mit dem Client beendet hat. Wenn die Konversation wiederhergestellt wird, versucht die DDEML, alle bereits vorhandene Advise-Schleifen wiederhergestellt zu haben.
DdeSetUserHandle Ordnet einem Konversationshand handle oder einem Transaktionsbezeichner einen anwendungsdefinierten Wert zu. Dies ist nützlich, um die Verarbeitung asynchroner Transaktionen zu vereinfachen. Eine Anwendung kann diesen Wert mithilfe der DdeQueryConvInfo-Funktion abrufen.
DdeUnaccessData Entnimmt den Zugriff auf ein DDE-Objekt. Eine Anwendung muss diese Funktion aufrufen, nachdem sie den Zugriff auf das Objekt abgeschlossen hat.
DdeUninitialize Gibt alle DDEML-Ressourcen frei, die der aufrufenden Anwendung zugeordnet sind.

DDEML-Transaktionen

Name BESCHREIBUNG
XTYP _ ADVDATA Informiert den Client darüber, dass sich der Wert des Datenelements geändert hat. Die DDE-Clientrückruffunktion DdeCallbackempfängt diese Transaktion, nachdem eine Advise-Schleife mit einem Server hergestellt wurde.
XTYP _ ADAKKAQ Informiert den Server darüber, dass eine Advise-Transaktion für das angegebene Themennamens- und Elementnamenpaar aus steht und dass sich daten entsprechend dem Themennamen- und Elementnamenpaar geändert haben. Das System sendet diese Transaktion an die DDE-Rückruffunktion DdeCallback,nachdem der Server die DdePostAdvise-Funktion aufruft.
XTYP _ ADVSTART Ein Client verwendet die XTYP _ ADVSTART-Transaktion, um eine Advise-Schleife mit einem Server herzustellen. Die DDE-Serverrückruffunktion DdeCallbackempfängt diese Transaktion, wenn ein Client XTYP _ ADVSTART als wType-Parameter der DdeClientTransaction-Funktion angibt.
XTYP _ ADVSTOP Ein Client verwendet die XTYP _ ADVSTOP-Transaktion, um eine Advise-Schleife mit einem Server zu beenden. Die DDE-Serverrückruffunktion DdeCallbackempfängt diese Transaktion, wenn ein Client XTYP _ ADVSTOP in der DdeClientTransaction-Funktion angibt.
XTYP _ CONNECT Ein Client verwendet die XTYP _ CONNECT-Transaktion, um eine Konversation herzustellen. Die DDE-Serverrückruffunktion DdeCallbackempfängt diese Transaktion, wenn ein Client einen vom Server unterstützten Dienstnamen (und einen Themennamen, der nicht NULL ist) in einem Aufruf der DdeConnect-Funktion angibt.
XTYP _ CONNECT _ CONFIRM Die DDE-Serverrückruffunktion DdeCallbackempfängt die XTYP _ CONNECT _ CONFIRM-Transaktion, um zu bestätigen, dass eine Konversation mit einem Client hergestellt wurde, und um dem Server das Konversationshandge zur Verfügung zu stellen. Das System sendet diese Transaktion als Ergebnis einer vorherigen XTYP _ CONNECT- oder XTYP _ WILDCONNECT-Transaktion.
XTYP _ DISCONNECT Die DDE-Rückruffunktion einer Anwendung, DdeCallback,empfängt die XTYP _ DISCONNECT-Transaktion, wenn der Partner der Anwendung in einer Konversation die DdeDisconnect-Funktion verwendet, um die Konversation zu beenden.
_XTYP-FEHLER Die DDE-Rückruffunktion DdeCallbackempfängt die XTYP _ ERROR-Transaktion, wenn ein kritischer Fehler auftritt.
XTYP _ EXECUTE Ein Client verwendet die XTYP _ EXECUTE-Transaktion, um eine Befehlszeichenfolge an den Server zu senden. Die DDE-Serverrückruffunktion DdeCallbackempfängt diese Transaktion, wenn ein Client XTYP _ EXECUTE in der DdeClientTransaction-Funktion angibt.
XTYP _ MONITOR Die DDE-Rückruffunktion eines DDE-Debuggers, DdeCallback,empfängt immer dann die XTYP _ MONITOR-Transaktion, wenn ein DDE-Ereignis im System auftritt. Um diese Transaktion zu empfangen, muss eine Anwendung den APPCLASS _ MONITOR-Wert angeben, wenn sie die DdeInitialize-Funktion aufruft.
XTYP _ POKE Ein Client verwendet die XTYP _ POKE-Transaktion, um nicht angeforderte Daten an den Server zu senden. Die DDE-Serverrückruffunktion DdeCallbackempfängt diese Transaktion, wenn ein Client XTYP _ POKE in der DdeClientTransaction-Funktion angibt.
XTYP _ REGISTER Die DDE-Rückruffunktion DdeCallbackempfängt den XTYP REGISTER-Transaktionstyp, _ wenn eine DDEML-Serveranwendung die DdeNameService-Funktion verwendet, um einen Dienstnamen zu registrieren, oder wenn eine Nicht-DDEML-Anwendung gestartet wird, die das Thema System unterstützt.
_XTYP-ANFORDERUNG Ein Client verwendet die XTYP _ REQUEST-Transaktion zum Anfordern von Daten von einem Server. Die DDE-Serverrückruffunktion DdeCallbackempfängt diese Transaktion, wenn ein Client XTYP _ REQUEST in der DdeClientTransaction-Funktion angibt.
XTYP _ UNREGISTER Die DDE-Rückruffunktion DdeCallbackempfängt die XTYP _ UNREGISTER-Transaktion, wenn eine DDEML-Serveranwendung die DdeNameService-Funktion verwendet, um die Registrierung eines Dienstnamens zu aufheben, oder wenn eine Nicht-DDEML-Anwendung, die das Systemthema unterstützt, beendet wird.
XTYP _ WILDCONNECT Mit der XTYP _ WILDCONNECT-Transaktion kann ein Client eine Konversation für jedes Der Dienstnamen- und Themennamenpaare des Servers herstellen, die mit dem angegebenen Dienst- und Themennamen übereinstimmen. Die DDE-Serverrückruffunktion DdeCallbackempfängt diese Transaktion, wenn ein Client einen NULL-Dienstnamen, einen NULL-Themennamen oder beides in einem Aufruf der DdeConnect- oder DdeConnectList-Funktion angibt.
XTYP _ XACT _ COMPLETE Die DDE-Clientrückruffunktion DdeCallbackempfängt die _ XTYP XACT _ COMPLETE-Transaktion, wenn eine asynchrone Transaktion, die durch einen Aufruf der DdeClientTransaction-Funktion initiiert wurde, abgeschlossen wurde.

DDEML-Strukturen

Name BESCHREIBUNG
CONVCONTEXT Enthält Informationen, die von einer DDE-Clientanwendung bereitgestellt werden. Die Informationen sind für spezialisierte oder sprachübergreifende DDE-Konversationen nützlich.
CONVINFO Enthält Informationen zu einer DDE-Konversation.
_DDEML-MSG-HOOKDATEN _ _ Enthält Informationen zu einer DDE-Nachricht und bietet Lesezugriff auf die Daten, auf die die Nachricht verweist. Diese Struktur ist für die Verwendung durch eine DDEML-Überwachungsanwendung vorgesehen.
MONCBSTRUCT Enthält Informationen zur aktuellen DDE-Transaktion. Eine DDE-Debuganwendung kann diese Struktur beim Überwachen von Transaktionen verwenden, die das System an die DDE-Rückruffunktionen anderer Anwendungen übergibt.
MONCONVSTRUCT Enthält Informationen zu einer DDE-Konversation. Eine DDE-Überwachungsanwendung kann diese Struktur verwenden, um Informationen zu einer Konversation zu erhalten, die eingerichtet oder beendet wurde.
MONERRSTRUCT Enthält Informationen zum aktuellen DDE-Fehler. Eine DDE-Überwachungsanwendung kann diese Struktur verwenden, um Fehler zu überwachen, die von Funktionen der DDE-Verwaltungsbibliothek zurückgegeben werden.
MONHSZSTRUCT Enthält Informationen zu einem DDE-Zeichenfolgenhand handle. Eine DDE-Überwachungsanwendung kann diese Struktur verwenden, wenn sie die Aktivität der Zeichenfolgen-Manager-Komponente der DDE-Verwaltungsbibliothek überwacht.
MONLINKSTRUCT Enthält Informationen zu einer DDE-Advise-Schleife. Eine DDE-Überwachungsanwendung kann diese Struktur verwenden, um Informationen zu einer Advise-Schleife zu erhalten, die gestartet oder beendet wurde.
MONMSGSTRUCT Enthält Informationen zu einer DDE-Nachricht. Eine DDE-Überwachungsanwendung kann diese Struktur verwenden, um Informationen zu einer gesendeten oder gesendeten DDE-Nachricht zu erhalten.