Compartir a través de


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

AddAtom

FindAtom

GlobalAddAtom

GlobalDeleteAtom

GlobalFindAtom

MAKEINTATOM

Referencia