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. |