Funzione GlobalFindAtomA (winbase.h)

Articolo
08/27/2023

Cerca la tabella atom globale per la stringa di caratteri specificata e recupera l'atomo globale associato a tale stringa.

Sintassi

ATOM GlobalFindAtomA(
  [in] LPCSTR lpString
);

Parametri

[in] lpString

Tipo: LPCTSTR

Stringa di caratteri con terminazione null per cui eseguire la ricerca.

In alternativa, è possibile usare un atomo intero convertito usando la macro MAKEINTATOM . Per altre informazioni, vedere le osservazioni.

Valore restituito

Tipo: ATOM

Se la funzione ha esito positivo, il valore restituito è l'atomo globale associato alla stringa specificata.

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

Commenti

Anche se il sistema mantiene il caso di una stringa in una tabella atoma come originariamente immesso, la ricerca eseguita da GlobalFindAtom non è distinzione tra maiuscole e minuscole.

Se lpString è stato creato dalla macro MAKEINTATOM , la parola a basso ordine deve trovarsi nell'intervallo 0x0001 tramite 0xBFFF. Se la parola a basso ordine non è in questo intervallo, la funzione ha esito negativo.

Nota

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

Requisiti


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