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

関連項目

AddAtom

FindAtom

GlobalAddAtom

GlobalDeleteAtom

GlobalFindAtom

MAKEINTATOM

参照