Função DeleteAtom (winbase.h)
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 |
Confira também
Referência