Функция DdeFreeStringHandle (ddeml.h)

Освобождает дескриптор строки в вызывающем приложении.

Синтаксис

BOOL DdeFreeStringHandle(
  [in] DWORD idInst,
  [in] HSZ   hsz
);

Параметры

[in] idInst

Тип: DWORD

Идентификатор экземпляра приложения, полученный при предыдущем вызове функции DdeInitialize .

[in] hsz

Тип: HSZ

Дескриптор для освобождаемого дескриптора строки. Этот дескриптор должен быть создан предыдущим вызовом функции DdeCreateStringHandle .

Возвращаемое значение

Тип: BOOL

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение.

Комментарии

Приложение может освободить созданные им строковые дескрипторы с помощью DdeCreateStringHandle , но не должно освобождать те, которые система передала в функцию обратного вызова динамического обмена данными (DDE) приложения, или те, которые возвращаются в структуре CONVINFO функцией DdeQueryConvInfo .

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header ddeml.h (включая Windows.h)
Библиотека User32.lib
DLL User32.dll

См. также раздел

CONVINFO

Основные понятия

DdeCmpStringHandles

DdeCreateStringHandle

DdeInitialize

DdeKeepStringHandle

DdeQueryConvInfo

DdeQueryString

Библиотека управления Динамическим обменом данными

Справочные материалы