Функция GlobalDeleteAtom (winbase.h)

Статья
08/27/2023

Уменьшает число ссылок глобального атома строк. Если число ссылок атома достигает нуля, GlobalDeleteAtom удаляет строку, связанную с атомом, из глобальной таблицы atom.

Синтаксис

ATOM GlobalDeleteAtom(
  [in] ATOM nAtom
);

Параметры

[in] nAtom

Тип: ATOM

Удаляемая строка атома и символов.

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

Тип: ATOM

Функция всегда возвращает (ATOM) 0.

Чтобы определить, произошел ли сбой функции, вызовите Метод SetLastError с ERROR_SUCCESS перед вызовом GlobalDeleteAtom, а затем вызовите Метод GetLastError. Если последний код ошибки по-прежнему ERROR_SUCCESS, GlobalDeleteAtom выполнено успешно.

Число ссылок в строковом атоме указывает количество добавлений строки в таблицу atom. Функция GlobalAddAtom увеличивает количество ссылок строки, которая уже существует в глобальной таблице atom при каждом вызове.

Каждый вызов GlobalAddAtom должен иметь соответствующий вызов GlobalDeleteAtom. Не вызывайте GlobalDeleteAtom больше раз, чем globalAddAtom, или вы можете удалить атом, пока его используют другие клиенты. Приложения, использующие динамический обмен данными (DDE), должны следовать правилам глобального управления атомами, чтобы предотвратить утечки и преждевременное удаление.

GlobalDeleteAtom не влияет на целочисленный атом (атом, значение которого находится в диапазоне 0x0001 0xBFFF). Функция всегда возвращает ноль для целочисленного атома.

Примеры

Пример см. в разделе Инициирование беседы.

Требования

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