Verwaltungsbibliothek für dynamische Daten

  • Artikel

Dynamischer Datenaustausch (Dynamic Data Exchange, DDE) ist eine Form der Interprozesskommunikation, die gemeinsam genutzten Arbeitsspeicher verwendet, um Daten zwischen Anwendungen auszutauschen. Anwendungen können DDE für einmalige Datenübertragungen sowie für den kontinuierlichen Austausch und die Aktualisierung von Daten verwenden.

In diesem Abschnitt

Name BESCHREIBUNG
Informationen zur DDEML Erläutert den dynamischen Datenaustausch.
Grundlegende Konzepte Erläutert wichtige Konzepte für den dynamischen Datenaustausch.
Konversationsverwaltung Erläutert Unterhaltungen zwischen einem Client und einem Server.
Datenverwaltung Erläutert, wie Speicherobjekte Daten von einer Anwendung an eine andere übergeben.
Anwendungen überwachen Erläutert, wie Elemente der Dynamischen Datenaustausch-Verwaltungsbibliothek verwendet werden können, um eine Anwendung zu erstellen, die dynamische Datenaustauschaktivitäten im System überwacht.
Name Service Erläutert, wie die Dynamic Data 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 abzurufen.
DDEML-Referenz Enthält den API-Verweis.

DDEML-Funktionen

Name BESCHREIBUNG
DdeAbandonTransaction 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 neue Daten bereits im Objekt enthaltene Daten überlappen, ü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 (Dynamic Data Exchange Management Library) verwendet wird. Sie verarbeitet DDE-Transaktionen. Der PFNCALLBACK-Typ definiert einen Zeiger auf diese Rückruffunktion. DdeCallback ist ein Platzhalter für den anwendungsdefinierte Funktionsnamen.
DdeClientTransaction Startet eine Datentransaktion zwischen einem Client und einem Server. Nur eine DDE-Clientanwendung kann diese Funktion aufrufen, und die Anwendung kann sie erst verwenden, nachdem eine Konversation mit dem Server hergestellt wurde.
DdeCmpStringHandles Vergleicht die Werte von zwei Zeichenfolgenhandles. Der Wert eines Zeichenfolgenhandles bezieht sich nicht auf die Groß- und Kleinschreibung der zugeordneten Zeichenfolge.
DdeConnect Richtet eine Konversation mit einer Serveranwendung ein, die das angegebene Dienstnamen- und Themennamenpaar unterstützt. Wenn mehrere solcher Server vorhanden sind, wählt das System nur einen 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 abzurufen, indem sie der Funktion ein vorhandenes Konversationshandle übergibt.
DdeCreateDataHandle Erstellt ein DDE-Objekt und füllt das Objekt mit Daten aus dem angegebenen Puffer. Eine DDE-Anwendung verwendet diese Funktion bei Transaktionen, bei denen Daten an die Partneranwendung übergeben werden.
DdeCreateStringHandle Erstellt ein Handle, das die angegebene Zeichenfolge identifiziert. Ein DDE-Client oder eine Serveranwendung kann das Zeichenfolgenhandle als Parameter an andere DDEML-Funktionen (Dynamic Data Exchange Management Library) übergeben.
DdeDisconnect Beendet eine Unterhaltung, die mit der Funktion DdeConnect oder DdeConnectList gestartet wurde, und ungültigiert das angegebene Konversationshandle.
DdeDisconnectList Zerstört die angegebene Unterhaltungsliste und beendet alle Unterhaltungen, die der Liste zugeordnet sind.
DdeEnableCallback Aktiviert oder deaktiviert Transaktionen für eine bestimmte Unterhaltung oder für alle Unterhaltungen, die derzeit von der aufrufenden Anwendung eingerichtet wurden.
DdeFreeDataHandle Gebühren für ein DDE-Objekt und löscht das dem Objekt zugeordnete Datenhandle.
DdeFreeStringHandle Gibt ein Zeichenfolgenhandle in der aufrufenden Anwendung frei.
DdeGetData Kopiert Daten aus dem angegebenen DDE-Objekt in den angegebenen lokalen Puffer.
DdeGetLastError Ruft den neuesten Fehlercode ab, der durch den Fehler einer DDEML-Funktion festgelegt wurde, und setzt den Fehlercode auf DMLERR_NO_ERROR zurück.
DdeImpersonateClient Imitiert eine DDE-Clientanwendung in einer DDE-Clientunterhaltung.
DdeInitialize Registriert eine Anwendung bei der Dynamic Data 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 Zeichenfolgenhandle speichern, das an die DDE-Rückruffunktion der Anwendung übergeben wird. Andernfalls wird ein an die Rückruffunktion übergebenes Zeichenfolgenhandle gelöscht, wenn die Rückruffunktion zurückgibt. Diese Funktion sollte auch verwendet werden, um eine Kopie eines Zeichenfolgenhandles beizubehalten, auf das von der CONVINFO-Struktur verwiesen wird, die von der DdeQueryConvInfo-Funktion zurückgegeben wird.
DdeNameService Registriert oder hebt die Registrierung der Dienstnamen auf, die ein DDE-Server unterstützt. Diese Funktion bewirkt, dass das System XTYP_REGISTER oder XTYP_UNREGISTER Transaktionen an andere ausgeführte DDEML-Clientanwendungen (Dynamic Data Exchange Management Library) sendet.
DdePostAdvise Sendet eine XTYP_ADVREQ Transaktion an die DDE-Rückruffunktion der aufrufenden (Server)-Anwendung für jeden Client mit einer aktiven Ratschlagschleife für das angegebene Thema und Element. Eine Serveranwendung sollte diese Funktion immer dann aufrufen, wenn sich die Daten ändern, die dem Themen- oder Elementnamenpaar zugeordnet sind.
DdeQueryConvInfo Ruft Informationen zu einer DDE-Transaktion und zu der Konversation ab, in der die Transaktion stattfindet.
DdeQueryNextServer Ruft das nächste Konversationshandle in der angegebenen Unterhaltungsliste ab.
DdeQueryString Kopiert Text, der einem Zeichenfolgenhandle zugeordnet ist, in einen Puffer.
DdeReconnect Ermöglicht es einer DDEML-Anwendung (Dynamic Data Exchange Management Library) des Clients, eine Konversation mit einem Dienst wiederherzustellen, der eine Konversation mit dem Client beendet hat. Wenn die Unterhaltung wiederhergestellt wird, versucht die DDEML, alle bereits vorhandenen Beratungsschleifen wiederherzustellen.
DdeSetUserHandle Ordnet einen anwendungsdefinierten Wert einem Konversationshandle oder einem Transaktionsbezeichner zu. Dies ist nützlich, um die Verarbeitung asynchroner Transaktionen zu vereinfachen. Eine Anwendung kann die DdeQueryConvInfo-Funktion verwenden, um diesen Wert abzurufen.
DdeUnaccessData Hebt den Zugriff auf ein DDE-Objekt auf. 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 DdeCallback empfängt diese Transaktion, nachdem sie eine Empfehlungsschleife mit einem Server erstellt hat.
XTYP_ADVREQ Informiert den Server darüber, dass eine Empfehlungstransaktion für das angegebene Themennamen- und Elementnamenpaar aussteht und dass die Daten, die dem Themennamen- und Elementnamenpaar entsprechen, geändert wurden. Das System sendet diese Transaktion an die DDE-Rückruffunktion DdeCallback, nachdem der Server die Funktion DdePostAdvise aufgerufen hat .
XTYP_ADVSTART Ein Client verwendet die XTYP_ADVSTART Transaktion, um eine Empfehlungsschleife mit einem Server einzurichten. Die DDE-Serverrückruffunktion DdeCallback empfä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 Empfehlungsschleife mit einem Server zu beenden. Die DDE-Serverrückruffunktion DdeCallback empfä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 DdeCallback empfä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 DdeCallback empfängt die XTYP_CONNECT_CONFIRM Transaktion, um zu bestätigen, dass eine Konversation mit einem Client eingerichtet wurde, und um dem Server das Konversationshandle bereitzustellen. 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 Unterhaltung die DdeDisconnect-Funktion verwendet, um die Konversation zu beenden.
XTYP_ERROR Die DDE-Rückruffunktion DdeCallback empfä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 DdeCallback empfängt diese Transaktion, wenn ein Client XTYP_EXECUTE in der Funktion DdeClientTransaction angibt .
XTYP_MONITOR Die DDECallback-Funktion eines DDE-Debuggers empfängt die XTYP_MONITOR Transaktion, wenn im System ein DDE-Ereignis 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 DdeCallback empfängt diese Transaktion, wenn ein Client XTYP_POKE in der DdeClientTransaction-Funktion angibt.
XTYP_REGISTER Die DDE-Rückruffunktion DdeCallback empfängt den XTYP_REGISTER Transaktionstyps, 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_REQUEST Ein Client verwendet die XTYP_REQUEST Transaktion, um Daten von einem Server anzufordern. Die DDE-Serverrückruffunktion DdeCallback empfängt diese Transaktion, wenn ein Client XTYP_REQUEST in der Funktion DdeClientTransaction angibt .
XTYP_UNREGISTER Die DDE-Rückruffunktion DdeCallback empfängt die XTYP_UNREGISTER Transaktion, wenn eine DDEML-Serveranwendung die DdeNameService-Funktion verwendet, um die Registrierung eines Dienstnamens aufzuheben, oder wenn eine Nicht-DDEML-Anwendung, die das Thema System unterstützt, beendet wird.
XTYP_WILDCONNECT Die XTYP_WILDCONNECT Transaktion ermöglicht es einem Client, eine Konversation für jedes Dienstnamen- und Themennamenpaar des Servers einzurichten, die dem angegebenen Dienstnamen und dem angegebenen Themennamen entsprechen. Die DDE-Serverrückruffunktion DdeCallback empfängt diese Transaktion, wenn ein Client einen NULL-Dienstnamen , einen NULL-Themennamen oder beides in einem Aufruf der Funktion DdeConnect oder DdeConnectList angibt.
XTYP_XACT_COMPLETE Die DDE-Clientrückruffunktion DdeCallback empfängt die XTYP_XACT_COMPLETE Transaktion, wenn eine asynchrone Transaktion abgeschlossen wurde, die durch einen Aufruf der DdeClientTransaction-Funktion initiiert wurde.

DDEML-Strukturen

Name BESCHREIBUNG
CONVCONTEXT Enthält Informationen, die von einer DDE-Clientanwendung bereitgestellt werden. Die Informationen sind nützlich für spezialisierte oder sprachübergreifende DDE-Unterhaltungen.
CONVINFO Enthält Informationen zu einer DDE-Unterhaltung.
DDEML_MSG_HOOK_DATA Enthält Informationen zu einer DDE-Nachricht und bietet Lesezugriff auf die Daten, auf die von der Nachricht verwiesen wird. Diese Struktur soll von einer DDEML-Überwachungsanwendung verwendet werden.
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-Unterhaltung. Eine DDE-Überwachungsanwendung kann diese Struktur verwenden, um Informationen zu einer Unterhaltung abzurufen, die eingerichtet oder beendet wurde.
MONERRSTRUCT Enthält Informationen zum aktuellen DDE-Fehler. Eine DDE-Überwachungsanwendung kann diese Struktur verwenden, um von DDE-Verwaltungsbibliotheksfunktionen zurückgegebene Fehler zu überwachen.
MONHSZSTRUCT Enthält Informationen zu einem DDE-Zeichenfolgenhandle. Eine DDE-Überwachungsanwendung kann diese Struktur verwenden, wenn die Aktivität der Zeichenfolgen-Manager-Komponente der DDE-Verwaltungsbibliothek überwacht wird.
MONLINKSTRUCT Enthält Informationen zu einer DDE-Empfehlungsschleife. Eine DDE-Überwachungsanwendung kann diese Struktur verwenden, um Informationen zu einer empfehlungsschleife abzurufen, die gestartet oder beendet wurde.
MONMSGSTRUCT Enthält Informationen zu einer DDE-Nachricht. Eine DDE-Überwachungsanwendung kann diese Struktur verwenden, um Informationen zu einer DDE-Nachricht abzurufen, die gesendet oder gepostet wurde.