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