Funzione DeleteAtom (winbase.h)
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 |
Vedere anche
Riferimento