Структура MONHSZSTRUCTA (ddeml.h)

Статья
08/23/2023

Содержит сведения о дескрипторове строки динамического обмена данными (DDE). Приложение мониторинга DDE может использовать эту структуру при мониторинге действий компонента диспетчера строк библиотеки управления DDE.

Синтаксис

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

Члены

cb

Тип: UINT

Размер структуры в байтах.

fsAction

Тип: BOOL

Действие, выполняемая в строке, определяемой элементом hsz .

Значение	Значение
MH_CLEANUP 4	Приложение освобождает свои ресурсы DDE, что приводит к удалению системой строковых дескрипторов, созданных приложением. (Приложение называется функцией DdeUninitialize .)
MH_CREATE 1	Приложение создает дескриптор строки. (Приложение называется функцией DdeCreateStringHandle .)
MH_DELETE 3	Приложение удаляет дескриптор строки. (Приложение называется функцией DdeFreeStringHandle .)
MH_KEEP 2	Приложение увеличивает число использования дескриптора строки. (Приложение называется функцией DdeKeepStringHandle .)

dwTime

Тип: DWORD

Время Windows, в которое выполняется действие, указанное элементом fsAction . Время Windows — это количество миллисекундах, прошедших с момента загрузки системы.

hsz

Тип: HSZ

Дескриптор строки. Поскольку дескрипторы строк являются локальными для процесса, этот элемент является глобальным атомом.

hTask

Тип: HANDLE

Дескриптор задачи (экземпляр приложения), выполняющий действие с дескриптором строки.

str[1]

Тип: TCHAR[1]

Указатель на строку, определяемую элементом hsz .

Заголовок ddeml.h определяет MONHSZSTRUCT как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Верхняя часть	ddeml.h (включая Windows.h)