Funzione GlobalAddAtomExA (winbase.h)
Aggiunge una stringa di caratteri alla tabella atom globale e restituisce un valore univoco (un atomo) che identifica la stringa.
Sintassi
ATOM GlobalAddAtomExA(
[in, optional] LPCSTR lpString,
[in] DWORD Flags
);
Parametri
[in, optional] lpString
Stringa con terminazione Null da aggiungere. La stringa può avere una dimensione massima di 255 byte. Le stringhe che differiscono solo nel caso sono considerate identiche. La distinzione tra maiuscole e minuscole della prima stringa di questo nome aggiunta alla tabella viene mantenuta e restituita dalla funzione GlobalGetAtomName .
In alternativa, è possibile utilizzare un atomo intero convertito utilizzando la macro MAKEINTATOM . Per altre informazioni, vedere la sezione Osservazioni.
[in] Flags
Valore restituito
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
Nota
L'intestazione winbase.h definisce GlobalAddAtomEx 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
| Piattaforma di destinazione | Windows |
| Intestazione | winbase.h (include Windows.h) |
| Libreria | Kernel32.lib |
| DLL | Kernel32.dll |