Функция GlobalDeleteAtom (winbase.h)
Уменьшает число ссылок глобального атома строк. Если число ссылок атома достигает нуля, 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 |
Справочные материалы