Função DeleteAtom (winbase.h)

Artigo
08/27/2023

Diminui a contagem de referência de um átomo de cadeia de caracteres local. Se a contagem de referência do átomo for reduzida a zero, DeleteAtom removerá a cadeia de caracteres associada ao átomo da tabela atom local.

Sintaxe

ATOM DeleteAtom(
  [in] ATOM nAtom
);

Parâmetros

[in] nAtom

Tipo: ATOM

O átomo a ser excluído.

Retornar valor

Tipo: ATOM

Se a função obtiver êxito, o valor retornado será zero.

Se a função falhar, o valor retornado será o parâmetro nAtom . Para obter informações de erro estendidas, chame GetLastError.

Comentários

A contagem de referência de um átomo de cadeia de caracteres especifica o número de vezes que o átomo foi adicionado à tabela atom. A função AddAtom incrementa a contagem em cada chamada. A função DeleteAtom diminui a contagem em cada chamada, mas remove a cadeia de caracteres somente se a contagem de referência do átomo for zero.

Cada chamada para AddAtom deve ter uma chamada correspondente para DeleteAtom. Não chame DeleteAtom mais vezes do que você chama AddAtom ou exclua o átomo enquanto outros clientes o estiverem usando.

A função DeleteAtom não tem efeito sobre um átomo inteiro (um átomo cujo valor está no intervalo 0x0001 a 0xBFFF). A função sempre retorna zero para um átomo inteiro.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winbase.h (inclua Windows.h)
Biblioteca	Kernel32.lib
DLL	Kernel32.dll