AddAtomW 函式（winbase.h）

發行項
11/20/2024

將字元字串新增至本機 atom 數據表，並傳回識別字串的唯一值（atom）。

語法

ATOM AddAtomW(
  [in] LPCWSTR lpString
);

參數

[in] lpString

類型：LPCTSTR

要加入的 Null 終止字串。字串的大小上限為 255 個字節。只有在案例中才會將字串視為相同。第一個新增字串的案例會保留並由 getAtomName 函式傳回。

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

傳回值

類型：ATOM

如果函式成功，傳回值就是新建立的 Atom。

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

言論

AddAtom 函式不會在 atom 數據表中儲存一個以上的指定字串複本。如果字串已經在數據表中，則函式會傳回現有的 Atom，並在字串 Atom 的情況下遞增字串的參考計數。

如果 lpString 格式為 “#1234”，AddAtom 會傳回整數 atom，其值為字符串中指定的十進制數的 16 位表示法（在此範例中為0x04D2）。如果指定的十進位值是0x0000或大於或等於0xC000，則傳回值為零，表示錯誤。如果 lpString 是由 MAKEINTATOM 巨集所建立，則低階字必須位於0x0001到0xBFFF的範圍中。如果低序字不在此範圍內，則函式會失敗。

如果 lpString 具有任何其他形式，AddAtom 會傳回字串 atom。

注意

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

要求

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