Structure MONHSZSTRUCTW (ddeml.h)

Article
02/26/2024

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

Syntaxe

typedef struct tagMONHSZSTRUCTW {
  UINT   cb;
  BOOL   fsAction;
  DWORD  dwTime;
  HSZ    hsz;
  HANDLE hTask;
  WCHAR  str[1];
} MONHSZSTRUCTW, *PMONHSZSTRUCTW;

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 entraîne la suppression par le système des handles de chaîne créés par l’application. (L’application a appelé la fonction DdeUninitialize .)
MH_CREATE 1	Une application crée un handle de chaîne. (L’application a appelé la fonction DdeCreateStringHandle .)
MH_DELETE 3	Une application supprime un handle de chaîne. (L’application a appelé la 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 est le 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 .

Remarques

Notes

L’en-tête ddeml.h définit MONHSZSTRUCT en tant qu’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. La combinaison 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.

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)