Bibliothèque de gestion d’Échange de données dynamiques
Dynamic Data Exchange (DDE) est une forme de communication interprocess qui utilise la mémoire partagée pour échanger des données entre les applications. Les applications peuvent utiliser DDE pour les transferts de données ponctuels et pour les échanges continus et la mise à jour des données.
Dans cette section
Nom | Description |
---|---|
À propos du DDEML | Traite de l’échange de données dynamique. |
Concepts de base | Décrit les concepts clés relatifs à l’échange dynamique de données. |
Gestion des conversations | Traite des conversations entre un client et un serveur. |
Gestion des données | Explique comment les objets de mémoire transmettent des données d’une application à une autre. |
Supervision des applications | Explique comment les éléments de la bibliothèque de gestion Dynamic Data Exchange peuvent être utilisés pour créer une application qui surveille l’activité d’échange de données dynamiques dans le système. |
Service de noms | Explique comment la bibliothèque de gestion Dynamic Data Exchange permet à une application serveur d’inscrire les noms de service qu’elle prend en charge. |
Gestion des transactions | Explique comment un client peut envoyer des transactions pour obtenir des données et des services à partir du serveur. |
Référence DDEML | Contient la référence d’API. |
Fonctions DDEML
Nom | Description |
---|---|
DdeAbandonTransaction | Abandonne la transaction asynchrone spécifiée et libère toutes les ressources associées à la transaction. |
DdeAccessData | Fournit l’accès aux données dans l’objet DDE spécifié. Une application doit appeler la fonction DdeUnaccessData lorsqu’elle a terminé d’accéder aux données de l’objet. |
DdeAddData | Ajoute des données à l’objet DDE spécifié. Une application peut ajouter des données à partir de n’importe quel décalage à partir du début de l’objet. Si de nouvelles données chevauchent des données déjà dans l’objet, les nouvelles données remplacent les anciennes données dans les octets où se produit le chevauchement. Le contenu des emplacements de l’objet qui n’ont pas été écrits dans n’est pas défini. |
DdeCallback | Fonction de rappel définie par l’application utilisée avec les fonctions DDEML (Dynamic Data Exchange Management Library). Il traite les transactions DDE. Le type PFNCALLBACK définit un pointeur vers cette fonction de rappel.
DdeCallback est un espace réservé pour le nom de fonction défini par l’application. |
DdeClientTransaction | Commence une transaction de données entre un client et un serveur. Seule une application cliente DDE peut appeler cette fonction, et l’application ne peut l’utiliser qu’après avoir établi une conversation avec le serveur. |
DdeCmpStringHandles | Compare les valeurs de deux handles de chaîne. La valeur d’un handle de chaîne n’est pas liée à la casse de la chaîne associée. |
DdeConnect | Établit une conversation avec une application serveur qui prend en charge le nom de service et la paire de noms de rubrique spécifiés. S’il existe plusieurs serveurs de ce type, le système n’en sélectionne qu’un seul. |
DdeConnectList | Établit une conversation avec toutes les applications serveur qui prennent en charge le nom de service et la paire de noms de rubrique spécifiés. Une application peut également utiliser cette fonction pour obtenir une liste de handles de conversation en transmettant à la fonction un handle de conversation existant. |
DdeCreateDataHandle | Crée un objet DDE et remplit l’objet avec les données de la mémoire tampon spécifiée. Une application DDE utilise cette fonction lors des transactions qui impliquent le passage de données à l’application partenaire. |
DdeCreateStringHandle | Crée un handle qui identifie la chaîne spécifiée. Une application cliente ou serveur DDE peut passer le handle de chaîne en tant que paramètre à d’autres fonctions DDEML (Dynamic Data Exchange Management Library). |
DdeDisconnect | Met fin à une conversation démarrée par la fonction DdeConnect ou DdeConnectList et invalide le handle de conversation spécifié. |
DdeDisconnectList | Détruit la liste de conversations spécifiée et met fin à toutes les conversations associées à la liste. |
DdeEnableCallback | Active ou désactive les transactions pour une conversation spécifique ou pour toutes les conversations actuellement établies par l’application appelante. |
DdeFreeDataHandle | Charge un objet DDE et supprime le handle de données associé à l’objet. |
DdeFreeStringHandle | Libère un handle de chaîne dans l’application appelante. |
DdeGetData | Copie les données de l’objet DDE spécifié vers la mémoire tampon locale spécifiée. |
DdeGetLastError | Récupère le code d’erreur le plus récent défini par l’échec d’une fonction DDEML et réinitialise le code d’erreur à DMLERR_NO_ERROR. |
DdeImpersonateClient | Emprunte l’identité d’une application cliente DDE dans une conversation de client DDE. |
DdeInitialize | Inscrit une application auprès de la bibliothèque de gestion DDEML (Dynamic Data Exchange Management Library). Une application doit appeler cette fonction avant d’appeler toute autre fonction DDEML. |
DdeKeepStringHandle | Incrémente le nombre d’utilisation associé au handle spécifié. Cette fonction permet à une application d’enregistrer un handle de chaîne passé à la fonction de rappel DDE de l’application. Sinon, un handle de chaîne passé à la fonction de rappel est supprimé lorsque la fonction de rappel est retournée. Cette fonction doit également être utilisée pour conserver une copie d’un handle de chaîne référencé par la structure CONVINFO retournée par la fonction DdeQueryConvInfo . |
DdeNameService | Inscrit ou annule l’inscription des noms de service pris en charge par un serveur DDE. Cette fonction permet au système d’envoyer des transactions XTYP_REGISTER ou XTYP_UNREGISTER à d’autres applications clientes DDEML (Dynamic Data Exchange Management Library) en cours d’exécution. |
DdePostAdvise | Envoie une transaction XTYP_ADVREQ à la fonction de rappel DDE de l’application appelante (serveur) pour chaque client avec une boucle de conseil active sur la rubrique et l’élément spécifiés. Une application serveur doit appeler cette fonction chaque fois que les données associées au nom de la rubrique ou à la paire nom d’élément changent. |
DdeQueryConvInfo | Récupère des informations sur une transaction DDE et sur la conversation dans laquelle la transaction a lieu. |
DdeQueryNextServer | Récupère le handle de conversation suivant dans la liste de conversations spécifiée. |
DdeQueryString | Copie le texte associé à un handle de chaîne dans une mémoire tampon. |
DdeReconnect | Permet à une application cliente de bibliothèque de gestion DDEML (Dynamic Data Exchange Management Library) d’essayer de rétablir une conversation avec un service qui a mis fin à une conversation avec le client. Lorsque la conversation est rétablie, le DDEML tente de rétablir toutes les boucles d’avertissement préexistantes. |
DdeSetUserHandle | Associe une valeur définie par l’application à un handle de conversation ou à un identificateur de transaction. Cela est utile pour simplifier le traitement des transactions asynchrones. Une application peut utiliser la fonction DdeQueryConvInfo pour récupérer cette valeur. |
DdeUnaccessData | Annule l’accès à un objet DDE. Une application doit appeler cette fonction une fois qu’elle a terminé d’accéder à l’objet . |
DdeUninitialize | Libère toutes les ressources DDEML associées à l’application appelante. |
DDEML Transactions
Nom | Description |
---|---|
XTYP_ADVDATA | Informe le client que la valeur de l’élément de données a changé. La fonction de rappel du client DDE, DdeCallback, reçoit cette transaction après avoir établi une boucle de conseil avec un serveur. |
XTYP_ADVREQ | Informe le serveur qu’une transaction d’avis est en suspens sur le nom de rubrique et la paire de noms d’élément spécifiés, et que les données correspondant à la paire nom de la rubrique et nom d’élément ont changé. Le système envoie cette transaction à la fonction de rappel DDE, DdeCallback, après que le serveur a appelé la fonction DdePostAdvise . |
XTYP_ADVSTART | Un client utilise la transaction XTYP_ADVSTART pour établir une boucle de conseil avec un serveur. Une fonction de rappel de serveur DDE, DdeCallback, reçoit cette transaction lorsqu’un client spécifie XTYP_ADVSTART comme paramètre wType de la fonction DdeClientTransaction . |
XTYP_ADVSTOP | Un client utilise la transaction XTYP_ADVSTOP pour mettre fin à une boucle d’avis avec un serveur. Une fonction de rappel de serveur DDE, DdeCallback, reçoit cette transaction lorsqu’un client spécifie XTYP_ADVSTOP dans la fonction DdeClientTransaction . |
XTYP_CONNECT | Un client utilise la transaction XTYP_CONNECT pour établir une conversation. Une fonction de rappel de serveur DDE, DdeCallback, reçoit cette transaction lorsqu’un client spécifie un nom de service que le serveur prend en charge (et un nom de rubrique qui n’est pas NULL) dans un appel à la fonction DdeConnect . |
XTYP_CONNECT_CONFIRM | Une fonction de rappel de serveur DDE, DdeCallback, reçoit la transaction XTYP_CONNECT_CONFIRM pour confirmer qu’une conversation a été établie avec un client et pour fournir au serveur le handle de conversation. Le système envoie cette transaction à la suite d’une transaction XTYP_CONNECT ou XTYP_WILDCONNECT précédente. |
XTYP_DISCONNECT | La fonction de rappel DDE d’une application, DdeCallback, reçoit la transaction XTYP_DISCONNECT lorsque le partenaire de l’application dans une conversation utilise la fonction DdeDisconnect pour mettre fin à la conversation. |
XTYP_ERROR | Une fonction de rappel DDE, DdeCallback, reçoit la transaction XTYP_ERROR lorsqu’une erreur critique se produit. |
XTYP_EXECUTE | Un client utilise la transaction XTYP_EXECUTE pour envoyer une chaîne de commande au serveur. Une fonction de rappel de serveur DDE, DdeCallback, reçoit cette transaction lorsqu’un client spécifie XTYP_EXECUTE dans la fonction DdeClientTransaction . |
XTYP_MONITOR | La fonction de rappel DDE d’un débogueur DDE, DdeCallback, reçoit la transaction XTYP_MONITOR chaque fois qu’un événement DDE se produit dans le système. Pour recevoir cette transaction, une application doit spécifier la valeur APPCLASS_MONITOR lorsqu’elle appelle la fonction DdeInitialize . |
XTYP_POKE | Un client utilise la transaction XTYP_POKE pour envoyer des données non sollicitées au serveur. Une fonction de rappel de serveur DDE, DdeCallback, reçoit cette transaction lorsqu’un client spécifie XTYP_POKE dans la fonction DdeClientTransaction . |
XTYP_REGISTER | Une fonction de rappel DDE, DdeCallback, reçoit le type de transaction XTYP_REGISTER chaque fois qu’une application serveur DDEML utilise la fonction DdeNameService pour inscrire un nom de service, ou chaque fois qu’une application non-DDEML qui prend en charge la rubrique Système est démarrée. |
XTYP_REQUEST | Un client utilise la transaction XTYP_REQUEST pour demander des données à un serveur. Une fonction de rappel de serveur DDE, DdeCallback, reçoit cette transaction lorsqu’un client spécifie XTYP_REQUEST dans la fonction DdeClientTransaction . |
XTYP_UNREGISTER | Une fonction de rappel DDE, DdeCallback, reçoit la transaction XTYP_UNREGISTER chaque fois qu’une application serveur DDEML utilise la fonction DdeNameService pour annuler l’inscription d’un nom de service, ou chaque fois qu’une application non-DDEML qui prend en charge la rubrique Système est arrêtée. |
XTYP_WILDCONNECT | La transaction XTYP_WILDCONNECT permet à un client d’établir une conversation sur chacune des paires nom de service et nom de rubrique du serveur qui correspondent au nom de service et au nom de la rubrique spécifiés. Une fonction de rappel de serveur DDE, DdeCallback, reçoit cette transaction lorsqu’un client spécifie un nom de service NULL , un nom de rubrique NULL ou les deux dans un appel à la fonction DdeConnect ou DdeConnectList . |
XTYP_XACT_COMPLETE | Une fonction de rappel de client DDE, DdeCallback, reçoit la transaction XTYP_XACT_COMPLETE lorsqu’une transaction asynchrone, initiée par un appel à la fonction DdeClientTransaction , est terminée. |
DDEML Structures
Nom | Description |
---|---|
CONVCONTEXT | Contient des informations fournies par une application cliente DDE. Ces informations sont utiles pour les conversations DDE spécialisées ou inter-langues. |
CONVINFO | Contient des informations sur une conversation DDE. |
DDEML_MSG_HOOK_DATA | Contient des informations sur un message DDE et fournit un accès en lecture aux données référencées par le message. Cette structure est destinée à être utilisée par une application de supervision DDEML. |
MONCBSTRUCT | Contient des informations sur la transaction DDE actuelle. Une application de débogage DDE peut utiliser cette structure lors de la surveillance des transactions que le système transmet aux fonctions de rappel DDE d’autres applications. |
MONCONVSTRUCT | Contient des informations sur une conversation DDE. Une application de supervision DDE peut utiliser cette structure pour obtenir des informations sur une conversation qui a été établie ou qui s’est terminée. |
MONERRSTRUCT | Contient des informations sur l’erreur DDE actuelle. Une application de supervision DDE peut utiliser cette structure pour surveiller les erreurs retournées par les fonctions de la bibliothèque de gestion DDE. |
MONHSZSTRUCT | Contient des informations sur un handle de chaîne DDE. Une application de supervision DDE peut utiliser cette structure lors de la surveillance de l’activité du composant gestionnaire de chaînes de la bibliothèque de gestion DDE. |
MONLINKSTRUCT | Contient des informations sur une boucle de conseil DDE. Une application de supervision DDE peut utiliser cette structure pour obtenir des informations sur une boucle de conseil qui a démarré ou s’est terminée. |
MONMSGSTRUCT | Contient des informations sur un message DDE. Une application de supervision DDE peut utiliser cette structure pour obtenir des informations sur un message DDE qui a été envoyé ou publié. |