DeleteAtom

ローカル文字列アトムの参照カウントを減らす。アトムの参照カウントが 0 まで減ると、DeleteAtom はそのアトムに関連付けられた文字列をローカルアトムテーブルから削除する。

DeleteAtom nAtom

nAtom : [int] 型: ATOM 削除するアトム。

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

解説

ローカル文字列アトムの参照カウントを減らす。アトムの参照カウントが 0 まで減ると、DeleteAtom
はそのアトムに関連付けられた文字列をローカルアトムテーブルから削除する。

[戻り値]
型: ATOM 関数が成功した場合、戻り値は 0 となる。関数が失敗した場合、戻り値は nAtom
パラメータとなる。拡張エラー情報を取得するには GetLastError を呼ぶ。

[備考]
文字列アトムの参照カウントは、アトムがアトムテーブルに追加された回数を表す。AddAtom
関数は呼び出しごとにカウントを増やす。DeleteAtom 関数は呼び出しごとにカウントを減らすが、アトムの参照カウントが 0
になった場合のみ文字列を削除する。AddAtom の各呼び出しには対応する DeleteAtom の呼び出しが必要である。AddAtom
より多く DeleteAtom を呼ぶと、他のクライアントが使用中にアトムを削除してしまうおそれがある。DeleteAtom
関数は整数アトム（0x0001 から 0xBFFF の範囲の値を持つアトム）には影響しない。整数アトムに対しては関数は常に 0 を返す。

情報