Función DeleteAtom (winbase.h)
Disminuye el recuento de referencias de un átomo de cadena local. Si el recuento de referencias del átomo se reduce a cero, DeleteAtom quita la cadena asociada al átomo de la tabla atom local.
Sintaxis
ATOM DeleteAtom(
[in] ATOM nAtom
);
Parámetros
[in] nAtom
Tipo: ATOM
El átomo que se va a eliminar.
Valor devuelto
Tipo: ATOM
Si la función es correcta, el valor devuelto es cero.
Si se produce un error en la función, el valor devuelto es el parámetro nAtom . Para obtener información de error extendida, llame a GetLastError.
Comentarios
El recuento de referencias de un átomo de cadena especifica el número de veces que se ha agregado el átomo a la tabla atom. La función AddAtom incrementa el recuento en cada llamada. La función DeleteAtom disminuye el recuento en cada llamada, pero quita la cadena solo si el recuento de referencias del átomo es cero.
Cada llamada a AddAtom debe tener una llamada correspondiente a DeleteAtom. No llame a DeleteAtom más veces de lo que llama a AddAtom, o puede eliminar el átomo mientras otros clientes lo usan.
La función DeleteAtom 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.
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 (incluye Windows.h) |
| Library | Kernel32.lib |
| Archivo DLL | Kernel32.dll |
Vea también
Referencia