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

Статья
11/20/2024

Содержит сведения о дескрипторе строки Динамического обмена данными (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 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
заголовка	ddeml.h (include Windows.h)