GlobalAddAtomExW 函式（winbase.h）

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

語法

ATOM GlobalAddAtomExW(
  [in, optional] LPCWSTR lpString,
  [in]           DWORD   Flags
);

[in, optional] lpString

要加入的 Null 終止字串。字串的大小上限為 255 個字節。只有在案例中才有差異的字串會視為相同。這個名稱新增至數據表的第一個字串大小寫會保留並由 GlobalGetAtomName 函式傳回。

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

[in] Flags

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

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

注意

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