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

Статья
08/23/2023

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

Синтаксис

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

Члены

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)