AddAtomW

ローカルアトムテーブルに文字列を追加し、その文字列を識別する一意の値（アトム）を返す。(Unicode)

AddAtomW lpString

lpString : [wstr] 型: LPCTSTR 追加する null 終端文字列。文字列の最大サイズは 255 バイト。大文字小文字のみ異なる文字列は同一とみなされる。最初に追加された文字列の大文字小文字は保持され、GetAtomName 関数で返される。代わりに、MAKEINTATOM マクロで変換した整数アトムを使用することもできる。詳細は備考を参照。

(プラグイン / モジュール : kernel32.dll)

解説

ローカルアトムテーブルに文字列を追加し、その文字列を識別する一意の値（アトム）を返す。(Unicode)

[戻り値]
型: ATOM 関数が成功した場合、戻り値は新しく作成されたアトム。関数が失敗した場合、戻り値はゼロ。拡張エラー情報を取得するには
GetLastError を呼ぶ。

[備考]
AddAtom 関数は、同じ文字列についてアトムテーブルに 1
つのコピーしか格納しない。文字列がすでにテーブルに存在する場合、関数は既存のアトムを返し、文字列アトムの場合は文字列の参照カウントをインクリメントする。lpString
が "#1234" の形式の場合、AddAtom は文字列で指定された 10 進数の 16 ビット表現（この例では
0x04D2）を値とする整数アトムを返す。指定された 10 進値が 0x0000 の場合、または 0xC000
以上の場合、戻り値はゼロでエラーを示す。lpString が MAKEINTATOM マクロで作成された場合、下位ワードは 0x0001
から 0xBFFF の範囲でなければならない。下位ワードがこの範囲にない場合、関数が失敗する。lpString
がその他の形式の場合、AddAtom は文字列アトムを返す。
> [!NOTE] > winbase.h ヘッダーは AddAtom を UNICODE プリプロセッサ定数の定義に基づいて ANSI
版または Unicode
版を自動選択するエイリアスとして定義している。エンコード中立エイリアスとそうでないコードを混在させると、コンパイルエラーや実行時エラーにつながる不一致が生じる可能性がある。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照。

情報