DeleteAtom 函式 (winbase.h)

遞減本機字串 Atom 的參考計數。如果 Atom 的參考計數縮減為零， DeleteAtom 會從本機 Atom 數據表中移除與 Atom 相關聯的字串。

語法

ATOM DeleteAtom(
  [in] ATOM nAtom
);

[in] nAtom

類型： ATOM

要刪除的 Atom。

類型： ATOM

如果此函式成功，則傳回值為零。

如果函式失敗，傳回值為 nAtom 參數。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

字串 atom 的參考計數會指定將 Atom 加入至 Atom 數據表的次數。 AddAtom 函式會遞增每個呼叫上的計數。 DeleteAtom 函式會遞減每個呼叫的計數，但只有在 Atom 的參考計數為零時，才會移除字串。

對 AddAtom 的每個呼叫都應該有對 DeleteAtom 的對應呼叫。請勿呼叫 DeleteAtom 超過您呼叫 AddAtom 的次數，或者您可以在其他用戶端使用它時刪除 Atom。

DeleteAtom 函式對整數 Atom 沒有任何作用， (其值位於範圍0x0001 0xBFFF) 。函式一律會傳回整數 Atom 的零。