Função GlobalDeleteAtom (winbase.h)

Artigo
03/03/2024

Diminui a contagem de referência de um átomo de cadeia de caracteres global. Se a contagem de referência do átomo atingir zero, GlobalDeleteAtom removerá a cadeia de caracteres associada ao átomo da tabela atom global.

Sintaxe

ATOM GlobalDeleteAtom(
  [in] ATOM nAtom
);

Parâmetros

[in] nAtom

Tipo: ATOM

O átomo e a cadeia de caracteres a serem excluídos.

Retornar valor

Tipo: ATOM

A função sempre retorna (ATOM) 0.

Para determinar se a função falhou, chame SetLastError com ERROR_SUCCESS antes de chamar GlobalDeleteAtom e chame GetLastError. Se o último código de erro ainda estiver ERROR_SUCCESS, GlobalDeleteAtom terá êxito.

Comentários

A contagem de referência de um átomo de cadeia de caracteres especifica o número de vezes que a cadeia de caracteres foi adicionada à tabela atom. A função GlobalAddAtom incrementa a contagem de referência de uma cadeia de caracteres que já existe na tabela atom global sempre que é chamada.

Cada chamada para GlobalAddAtom deve ter uma chamada correspondente para GlobalDeleteAtom. Não chame GlobalDeleteAtom mais vezes do que você chama GlobalAddAtom, ou você pode excluir o átomo enquanto outros clientes o estiverem usando. Os aplicativos que usam o DDE (Troca Dinâmica de Dados) devem seguir as regras sobre o gerenciamento atom global para evitar vazamentos e exclusão prematura.

GlobalDeleteAtom 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.

Exemplos

Para obter um exemplo, consulte Iniciando uma conversa.

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