Funzione AddAtomW (winbase.h)

Articolo
11/20/2024

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'atom appena creato.

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

Osservazioni

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'atom 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 in ordine basso deve essere compresa nell'intervallo 0x0001 da 0xBFFF. Se la parola in ordine basso non è in questo intervallo, la funzione ha esito negativo.

Se lpString ha un altro formato, AddAtom restituisce un atom 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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	winbase.h (include Windows.h)
libreria	Kernel32.lib
dll	Kernel32.dll