MONHSZSTRUCTA structure (ddeml.h)

Contains information about a Dynamic Data Exchange (DDE) string handle. A DDE monitoring application can use this structure when monitoring the activity of the string manager component of the DDE Management Library.

Syntax

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

Members

cb

Type: UINT

The structure's size, in bytes.

fsAction

Type: BOOL

The action being performed on the string identified by the hsz member.

Value Meaning
MH_CLEANUP
4
An application is freeing its DDE resources, causing the system to delete string handles the application had created. (The application called the DdeUninitialize function.)
MH_CREATE
1
An application is creating a string handle. (The application called the DdeCreateStringHandle function.)
MH_DELETE
3
An application is deleting a string handle. (The application called the DdeFreeStringHandle function.)
MH_KEEP
2
An application is increasing the usage count of a string handle. (The application called the DdeKeepStringHandle function.)

dwTime

Type: DWORD

The Windows time at which the action specified by the fsAction member takes place. Windows time is the number of milliseconds that have elapsed since the system was booted.

hsz

Type: HSZ

A handle to the string. Because string handles are local to the process, this member is a global atom.

hTask

Type: HANDLE

A handle to the task (application instance) performing the action on the string handle.

str[1]

Type: TCHAR[1]

Pointer to the string identified by the hsz member.

Remarks

Note

The ddeml.h header defines MONHSZSTRUCT as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Header ddeml.h (include Windows.h)

See also

Conceptual

Dynamic Data Exchange Management Library

MONCBSTRUCT

MONCONVSTRUCT

MONERRSTRUCT

MONLINKSTRUCT

MONMSGSTRUCT

Reference