Función GlobalDeleteAtom (winbase.h)
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 |
Vea también
Referencia