Funzione GlobalAddAtomExW (winbase.h)

Articolo
11/20/2024

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

Sintassi

ATOM GlobalAddAtomExW(
  [in, optional] LPCWSTR 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 siano considerate identiche. Il caso 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'atom appena creato.

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

Osservazioni

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 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
piattaforma di destinazione	Finestre
intestazione	winbase.h (include Windows.h)
libreria	Kernel32.lib
dll	Kernel32.dll

Vedere anche

GlobalAddAtom

Condividi tramite