AddAtomW 函式 (winbase.h)

發行項
03/03/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 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	winbase.h (包含 Windows.h)
程式庫	Kernel32.lib
DLL	Kernel32.dll