Funzione GlobalFindAtomA (winbase.h)
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 |
Vedere anche
Riferimento