Funzione DeleteAtom (winbase.h)

Articolo
03/13/2024

Decrementa il conteggio dei riferimenti di un atomo di stringa locale. Se il numero di riferimenti dell'atomo è ridotto a zero, DeleteAtom rimuove la stringa associata all'atomo dalla tabella atom locale.

Sintassi

ATOM DeleteAtom(
  [in] ATOM nAtom
);

Parametri

[in] nAtom

Tipo: ATOM

Atom da eliminare.

Valore restituito

Tipo: ATOM

Se la funzione ha esito positivo, il valore restituito è zero.

Se la funzione ha esito negativo, il valore restituito è il parametro nAtom . Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Il numero di riferimenti di un atomo di stringa specifica il numero di volte in cui l'atomo è stato aggiunto alla tabella atom. La funzione AddAtom incrementa il conteggio in ogni chiamata. La funzione DeleteAtom decrementa il conteggio in ogni chiamata, ma rimuove la stringa solo se il numero di riferimenti dell'atomo è zero.

Ogni chiamata a AddAtom deve avere una chiamata corrispondente a DeleteAtom. Non chiamare DeleteAtom più volte di quanto si chiama AddAtom oppure è possibile eliminare l'atomo mentre altri client lo usano.

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

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