Structure MONLINKSTRUCT (ddeml.h)

Article
02/29/2024

Contient des informations sur une boucle d’avis DDE (Dynamic Data Exchange). 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.

Syntaxe

typedef struct tagMONLINKSTRUCT {
  UINT   cb;
  DWORD  dwTime;
  HANDLE hTask;
  BOOL   fEstablished;
  BOOL   fNoData;
  HSZ    hszSvc;
  HSZ    hszTopic;
  HSZ    hszItem;
  UINT   wFmt;
  BOOL   fServer;
  HCONV  hConvServer;
  HCONV  hConvClient;
} MONLINKSTRUCT, *PMONLINKSTRUCT;

Membres

cb

Type : UINT

Taille de la structure, en octets.

dwTime

Type : DWORD

Heure Windows à laquelle la boucle d’avertissement a été démarrée ou terminée. Le temps Windows est le nombre de millisecondes qui se sont écoulées depuis le démarrage du système.

hTask

Type : HANDLE

Handle pour une tâche (application instance) qui est un partenaire dans la boucle de conseil.

fEstablished

Type : BOOL

Indique si une boucle d’avertissement a été établie avec succès. La valeur TRUE indique qu’une boucle de conseil a été établie ; FALSE indique que ce n’était pas le cas.

fNoData

Type : BOOL

Indique si l’indicateur XTYPF_NODATA est défini pour la boucle de conseil. La valeur TRUE indique que l’indicateur est défini ; FALSE indique que ce n’est pas le cas.

hszSvc

Type : HSZ

Handle du nom de service du serveur dans la boucle de conseil.

hszTopic

Type : HSZ

Handle du nom de la rubrique sur laquelle la boucle de conseil est établie.

hszItem

Type : HSZ

Handle du nom d’élément qui fait l’objet de la boucle de conseil.

wFmt

Type : UINT

Format des données échangées (le cas échéant) pendant la boucle de conseil.

fServer

Type : BOOL

Indique si la notification de lien provient du serveur. La valeur TRUE indique que la notification provient du serveur ; FALSE indique le contraire.

hConvServer

Type : HCONV

Handle de la conversation du serveur.

hConvClient

Type : HCONV

Handle de la conversation cliente.

Remarques

Étant donné que les handles de chaîne sont locaux au processus, les membres hszSvc, hszTopic et hszItem sont des atomes globaux.

Les membres hConvClient et hConvServer de la structure MONLINKSTRUCT ne contiennent pas la même valeur que les applications engagées dans la conversation. Au lieu de cela, ils contiennent une paire globale unique de valeurs qui identifient la conversation.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	ddeml.h (inclure Windows.h)