GlobalGetAtomNameA 函式 （winbase.h）
擷取與指定之全域 Atom 相關聯的字元字串複本。
語法
UINT GlobalGetAtomNameA(
[in] ATOM nAtom,
[out] LPSTR lpBuffer,
[in] int nSize
);
參數
[in] nAtom
類型：ATOM
與要擷取之字元字串相關聯的全域 Atom。
[out] lpBuffer
類型：LPTSTR
字元字串的緩衝區。
[in] nSize
類型：int
緩衝區的大小，以字元為單位。
傳回值
類型：UINT
如果函式成功，傳回值會是複製到緩衝區的字串長度，以字元為單位，不包括終止的 Null 字元。
如果函式失敗，傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。
言論
針對整數 atom 傳回的字串（其值在範圍中0x0001至0xBFFF的 atom）是 null 終止的字串，其中第一個字元是磅號 （#） ，而其餘字元則代表不帶正負號的整數 atom 值。
安全性考慮
使用此函式不正確可能會危害程序的安全性。 這個函式的使用不正確，包括未正確指定 lpBuffer 參數的大小。 此外，請注意，任何人都可以存取全域原子;因此，隱私權和其內容的完整性是無法保證的。注意
winbase.h 標頭會將 GlobalGetAtomName 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 支援的最低伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平臺 | 窗戶 |
| 標頭 | winbase.h （包括 Windows.h） |
| 連結庫 | Kernel32.lib |
| DLL | Kernel32.dll |
另請參閱
參考