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

Статья
08/27/2023

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

Синтаксис

ATOM DeleteAtom(
  [in] ATOM nAtom
);

Параметры

[in] nAtom

Тип: ATOM

Удаляемая атома.

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

Тип: ATOM

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

Если функция завершается сбоем, возвращаемым значением является параметр nAtom . Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

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

Каждый вызов AddAtom должен иметь соответствующий вызов DeleteAtom. Не вызывайте DeleteAtom больше раз, чем при вызове AddAtom, или вы можете удалить atom, когда другие клиенты используют его.

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

Требования

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