Funzione GlobalDeleteAtom (winbase.h)

Articolo
03/03/2024

Decrementa il conteggio dei riferimenti di un atomo di stringa globale. Se il conteggio dei riferimenti dell'atomo raggiunge zero, GlobalDeleteAtom rimuove la stringa associata all'atomo dalla tabella atom globale.

Sintassi

ATOM GlobalDeleteAtom(
  [in] ATOM nAtom
);

Parametri

[in] nAtom

Tipo: ATOM

Stringa di caratteri e atom da eliminare.

Valore restituito

Tipo: ATOM

La funzione restituisce sempre (ATOM) 0.

Per determinare se la funzione non è riuscita, chiamare SetLastError con ERROR_SUCCESS prima di chiamare GlobalDeleteAtom, quindi chiamare GetLastError. Se l'ultimo codice di errore è ancora ERROR_SUCCESS, GlobalDeleteAtom ha avuto esito positivo.

Commenti

Il numero di riferimenti di un atomo stringa specifica il numero di volte in cui la stringa è stata aggiunta alla tabella atom. La funzione GlobalAddAtom incrementa il conteggio dei riferimenti di una stringa già esistente nella tabella atom globale ogni volta che viene chiamata.

Ogni chiamata a GlobalAddAtom deve avere una chiamata corrispondente a GlobalDeleteAtom. Non chiamare GlobalDeleteAtom più volte di quanto chiami GlobalAddAtom oppure puoi eliminare l'atom mentre altri client lo usano. Le applicazioni che usano Dynamic Data Exchange (DDE) devono seguire le regole sulla gestione globale degli atom per evitare perdite ed eliminazione prematura.

GlobalDeleteAtom non ha alcun effetto su un atomo intero (un atomo il cui valore è compreso nell'intervallo 0x0001 a 0xBFFF). La funzione restituisce sempre zero per un atomo intero.

Esempio

Per un esempio, vedere Avvio di una conversazione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winbase.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll