GlobalAddAtomA 函式 （winbase.h）
將字元字串新增至全域 atom 數據表，並傳回識別字串的唯一值（atom）。
語法
ATOM GlobalAddAtomA(
[in] LPCSTR lpString
);
參數
[in] lpString
類型：LPCTSTR
要加入的 Null 終止字串。 字串的大小上限為 255 個字節。 只有在案例中才有差異的字串會視為相同。 這個名稱新增至數據表的第一個字串大小寫會保留並由 GlobalGetAtomName 函式傳回。
或者，您可以使用已使用makeINTATOM 巨集
傳回值
類型：ATOM
如果函式成功，傳回值就是新建立的 Atom。
如果函式失敗，傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。
言論
如果字串已經存在於全域 Atom 數據表中，則會傳回現有字串的 Atom，並遞增 Atom 的參考計數。
除非其參考計數為零，否則不會從記憶體中刪除與 atom 相關聯的字串。 如需詳細資訊，請參閱 GlobalDeleteAtom 函式。
應用程式終止時，不會自動刪除全域原子。 對於 GlobalAddAtom 函式的每個呼叫，都必須有對應呼叫 GlobalDeleteAtom 函式。
如果 lpString 參數的格式為 “#1234”，GlobalAddAtom 會傳回整數 atom，其值為字符串中指定的十進制數的 16 位表示法（在此範例中為0x04D2）。 如果指定的十進位值是0x0000或大於或等於0xC000，則傳回值為零，表示錯誤。 如果
如果 lpString 具有任何其他形式，GlobalAddAtom 會傳回字串 atom。
注意
winbase.h 標頭會將 GlobalAddAtom 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 支援的最低伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平臺 | 窗戶 |
| 標頭 | winbase.h （包括 Windows.h） |
| 連結庫 | Kernel32.lib |
| DLL | Kernel32.dll |
另請參閱
參考