DeleteAtom 関数 (winbase.h)
ローカル文字列アトムの参照カウントをデクリメントします。 アトムの参照カウントが 0 に減った場合、 DeleteAtom は、ローカルの atom テーブルから atom に関連付けられている文字列を削除します。
構文
ATOM DeleteAtom(
[in] ATOM nAtom
);
パラメーター
[in] nAtom
種類: ATOM
削除するアトム。
戻り値
種類: ATOM
関数が成功した場合の戻り値は 0 です。
関数が失敗した場合、戻り値は nAtom パラメーターです。 詳細なエラー情報を得るには、GetLastError を呼び出します。
解説
文字列アトムの参照カウントは、atom テーブルに atom が追加された回数を指定します。 AddAtom 関数は、呼び出しごとにカウントをインクリメントします。 DeleteAtom 関数は、各呼び出しでカウントをデクリメントしますが、atom の参照カウントが 0 の場合にのみ文字列を削除します。
AddAtom の各呼び出しには、DeleteAtom への対応する呼び出しが必要です。 AddAtom を呼び出すよりも DeleteAtom を複数回呼び出さないでください。または、他のクライアントが使用している間に atom を削除することもできます。
DeleteAtom 関数は、整数のアトム (値が0xBFFF 0x0001範囲内にある atom) には影響しません。 この関数は、整数のアトムに対して常に 0 を返します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | winbase.h (Windows.h を含む) |
| Library | Kernel32.lib |
| [DLL] | Kernel32.dll |
関連項目
参照