GlobalDeleteAtom 関数 (winbase.h)
グローバル文字列アトムの参照カウントをデクリメントします。 アトムの参照カウントが 0 に達すると、 GlobalDeleteAtom はグローバル atom テーブルから atom に関連付けられている文字列を削除します。
構文
ATOM GlobalDeleteAtom(
[in] ATOM nAtom
);
パラメーター
[in] nAtom
種類: ATOM
削除するアトムと文字列。
戻り値
種類: ATOM
関数は常に (ATOM) 0 を返します。
関数が失敗したかどうかを判断するには、GlobalDeleteAtom を呼び出す前に、ERROR_SUCCESSを指定して SetLastError を呼び出し、GetLastError を呼び出します。 最後のエラー コードがまだ ERROR_SUCCESS場合、 GlobalDeleteAtom は成功しました。
注釈
文字列アトムの参照カウントは、atom テーブルに文字列が追加された回数を指定します。 GlobalAddAtom 関数は、グローバル アトム テーブルに既に存在する文字列の参照カウントを、呼び出されるたびにインクリメントします。
GlobalAddAtom の各呼び出しには、GlobalDeleteAtom への対応する呼び出しが必要です。 GlobalAddAtom を呼び出すよりも多くの回数 GlobalDeleteAtom を呼び出さないでください。または、他のクライアントが使用している間に atom を削除することもできます。 Dynamic Data Exchange (DDE) を使用するアプリケーションは、リークや早期削除を防ぐために、グローバルアトム管理に関する規則に従う必要があります。
GlobalDeleteAtom は、整数の原子 (値が 0xBFFF に0x0001範囲内にある atom) には影響しません。 この関数は、整数のアトムに対して常に 0 を返します。
例
例については、「 会話の開始」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | winbase.h (Windows.h を含む) |
| Library | Kernel32.lib |
| [DLL] | Kernel32.dll |
関連項目
参照