GlobalDeleteAtom

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

GlobalDeleteAtom nAtom

nAtom : [int] 型: ATOM 削除するアトムと文字列。

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

解説

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

[戻り値]
型: ATOM 関数は常に (ATOM) 0 を返す。関数が失敗したかどうかを判定するには、GlobalDeleteAtom
を呼び出す前に SetLastError を ERROR_SUCCESS で呼び、その後 GetLastError
を呼ぶ。最後のエラーコードがまだ ERROR_SUCCESS の場合、GlobalDeleteAtom は成功している。

[備考]
文字列アトムの参照カウントは、文字列がアトムテーブルに追加された回数を指定する。GlobalAddAtom
関数は、グローバルアトムテーブルに既に存在する文字列の参照カウントを呼び出されるたびに増分する。GlobalAddAtom
の各呼び出しは、対応する GlobalDeleteAtom の呼び出しを持つべきである。GlobalAddAtom
を呼び出した回数より多く GlobalDeleteAtom
を呼び出すと、他のクライアントが使用しているアトムを削除する可能性がある。Dynamic Data Exchange (DDE)
を使用するアプリケーションは、リークと早期削除を防ぐためにグローバルアトム管理のルールに従うべきである。GlobalDeleteAtom
は整数アトム（値が 0x0001 から 0xBFFF の範囲内のアトム）には影響を与えない。関数は整数アトムに対して常に 0 を返す。

情報