Structure MONHSZSTRUCTA (ddeml.h)

Article
08/23/2023

Contient des informations sur un handle de chaîne DDE (Dynamic Data Exchange). Une application de surveillance 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.

Syntaxe

typedef struct tagMONHSZSTRUCTA {
  UINT   cb;
  BOOL   fsAction;
  DWORD  dwTime;
  HSZ    hsz;
  HANDLE hTask;
  CHAR   str[1];
} MONHSZSTRUCTA, *PMONHSZSTRUCTA;

Membres

cb

Type : UINT

Taille de la structure, en octets.

fsAction

Type : BOOL

Action en cours d’exécution sur la chaîne identifiée par le membre hsz .

Valeur	Signification
MH_CLEANUP 4	Une application libère ses ressources DDE, ce qui oblige le système à supprimer les handles de chaîne que l’application avait créés. (Application appelée fonction DdeUninitialize .)
MH_CREATE 1	Une application crée un handle de chaîne. (L’application appelée fonction DdeCreateStringHandle .)
MH_DELETE 3	Une application supprime un handle de chaîne. (L’application appelée fonction DdeFreeStringHandle .)
MH_KEEP 2	Une application augmente le nombre d’utilisations d’un handle de chaîne. (L’application a appelé la fonction DdeKeepStringHandle .)

dwTime

Type : DWORD

Heure Windows à laquelle l’action spécifiée par le membre fsAction a lieu. Le temps Windows correspond au nombre de millisecondes qui se sont écoulées depuis le démarrage du système.

hsz

Type : HSZ

Handle de la chaîne. Étant donné que les handles de chaîne sont locaux au processus, ce membre est un atome global.

hTask

Type : HANDLE

Handle de la tâche (application instance) qui effectue l’action sur le handle de chaîne.

str[1]

Type : TCHAR[1]

Pointeur vers la chaîne identifiée par le membre hsz .

Notes

L’en-tête ddeml.h définit MONHSZSTRUCT comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Spécifications


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)