GlobalFindAtomA 函式（winbase.h）

搜尋全域 atom 數據表中的指定字元字串，並擷取與該字串相關聯的全域 Atom。

語法

ATOM GlobalFindAtomA(
  [in] LPCSTR lpString
);

[in] lpString

類型：LPCTSTR

要搜尋的 Null 終止字元字串。

或者，您可以使用已使用makeINTATOM 巨集轉換的整數 atom。如需詳細資訊，請參閱。

類型：ATOM

如果函式成功，傳回值就是與指定字串相關聯的全域 Atom。

如果函式失敗，傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

雖然系統在最初輸入時會保留atom數據表中的字串大小寫，但 globalFindAtom 所執行的搜尋不會區分大小寫。

如果 lpString 是由 MAKEINTATOM 巨集所建立，則低階字必須位於0x0001到0xBFFF的範圍中。如果低序字不在此範圍內，則函式會失敗。

注意

winbase.h 標頭會將 GlobalFindAtom 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

要求	價值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平臺	窗戶
標頭	winbase.h （包括 Windows.h）
連結庫	Kernel32.lib
DLL	Kernel32.dll