globalDeleteAtom 函式 (winbase.h)

發行項
03/13/2024

遞減全域字串 Atom 的參考計數。如果 Atom 的參考計數達到零， GlobalDeleteAtom 會從全域 Atom 數據表中移除與 Atom 相關聯的字串。

語法

ATOM GlobalDeleteAtom(
  [in] ATOM nAtom
);

參數

[in] nAtom

類型： ATOM

要刪除的 Atom 和字元字串。

傳回值

類型： ATOM

函式一律會傳回 ATOM) 0 (。

若要判斷函式是否失敗，請先使用 ERROR_SUCCESS 呼叫 SetLastError，再呼叫 GlobalDeleteAtom，然後呼叫 GetLastError。如果最後一個錯誤碼仍然ERROR_SUCCESS，GlobalDeleteAtom 已成功。

備註

字串 Atom 的參考計數會指定字串已加入至 Atom 數據表的次數。 GlobalAddAtom 函式會在每次呼叫時，遞增已存在於全域 Atom 數據表中的字串參考計數。

每個 GlobalAddAtom 呼叫都應該有 GlobalDeleteAtom 的對應呼叫。請勿呼叫 GlobalDeleteAtom 超過您呼叫 GlobalAddAtom 的次數，或者您可以在其他用戶端使用它時刪除 Atom。使用動態數據交換 (DDE) 的應用程式應遵循全域 Atom 管理的規則，以避免外洩和提前刪除。

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

範例

如需範例，請參閱起始交談。

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	winbase.h (包含 Windows.h)
程式庫	Kernel32.lib
DLL	Kernel32.dll