Función GlobalDeleteAtom (winbase.h)

Artículo
03/03/2024

Disminuye el recuento de referencias de un átomo de cadena global. Si el recuento de referencias del átomo alcanza cero, GlobalDeleteAtom quita la cadena asociada al átomo de la tabla atom global.

Sintaxis

ATOM GlobalDeleteAtom(
  [in] ATOM nAtom
);

Parámetros

[in] nAtom

Tipo: ATOM

Cadena de átomos y caracteres que se va a eliminar.

Valor devuelto

Tipo: ATOM

La función siempre devuelve (ATOM) 0.

Para determinar si se ha producido un error en la función, llame a SetLastError con ERROR_SUCCESS antes de llamar a GlobalDeleteAtom y, a continuación, llame a GetLastError. Si el último código de error sigue ERROR_SUCCESS, GlobalDeleteAtom se ha realizado correctamente.

Comentarios

El recuento de referencias de un átomo de cadena especifica el número de veces que se ha agregado la cadena a la tabla atom. La función GlobalAddAtom incrementa el recuento de referencias de una cadena que ya existe en la tabla atom global cada vez que se llama.

Cada llamada a GlobalAddAtom debe tener una llamada correspondiente a GlobalDeleteAtom. No llames a GlobalDeleteAtom más veces de lo que llamas a GlobalAddAtom, o puedes eliminar el átomo mientras otros clientes lo usan. Las aplicaciones que usan el intercambio dinámico de datos (DDE) deben seguir las reglas de administración global de átomos para evitar fugas y eliminación prematura.

GlobalDeleteAtom no tiene ningún efecto en un átomo entero (un átomo cuyo valor está en el intervalo 0x0001 a 0xBFFF). La función siempre devuelve cero para un átomo entero.

Ejemplos

Para obtener un ejemplo, consulte Iniciar una conversación.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winbase.h (incluya Windows.h)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll