Funzione AddAtomW (winbase.h)

Articolo
03/08/2023

Aggiunge una stringa di caratteri alla tabella atom locale e restituisce un valore univoco (un atomo) che identifica la stringa.

Sintassi

ATOM AddAtomW(
  [in] LPCWSTR lpString
);

Parametri

[in] lpString

Tipo: LPCTSTR

Stringa con terminazione Null da aggiungere. La stringa può avere una dimensione massima di 255 byte. Le stringhe che differiscono solo nel caso siano considerate identiche. La distinzione tra maiuscole e minuscole della prima stringa aggiunta viene mantenuta e restituita dalla funzione GetAtomName .

In alternativa, è possibile utilizzare un atomo intero convertito utilizzando la macro MAKEINTATOM . Per altre informazioni, vedere la sezione Osservazioni.

Valore restituito

Tipo: ATOM

Se la funzione ha esito positivo, il valore restituito è l'atomo appena creato.

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

Commenti

La funzione AddAtom archivia non più di una copia di una determinata stringa nella tabella atom. Se la stringa è già presente nella tabella, la funzione restituisce l'atomo esistente e, nel caso di un atomo di stringa, incrementa il conteggio dei riferimenti della stringa.

Se lpString ha il formato "#1234", AddAtom restituisce un atomo intero il cui valore è la rappresentazione a 16 bit del numero decimale specificato nella stringa (0x04D2, in questo esempio). Se il valore decimale specificato è 0x0000 o è maggiore o uguale a 0xC000, il valore restituito è zero, che indica un errore. Se lpString è stato creato dalla macro MAKEINTATOM , la parola di ordine basso deve trovarsi nell'intervallo 0x0001 tramite 0xBFFF. Se la parola di ordine basso non è in questo intervallo, la funzione ha esito negativo.

Se lpString ha un altro formato, AddAtom restituisce un atomo di stringa.

Nota

L'intestazione winbase.h definisce AddAtom come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

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