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