FindAtomA 函式 (winbase.h)

搜尋本機 Atom 資料表中的指定字元字串，並擷取與該字串相關聯的 Atom。

語法

ATOM FindAtomA(
  [in] LPCSTR lpString
);

[in] lpString

類型： LPCTSTR

要搜尋的字元字串。

或者，您可以使用已使用 MAKEINTATOM 宏轉換的整數 Atom。如需詳細資訊，請參閱「備註」。

類型： ATOM

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

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

即使系統會保留 Atom 資料表中的字串大小寫， FindAtom 函式所執行的搜尋不會區分大小寫。

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

注意

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