GlobalGetAtomNameW

指定したグローバルアトムに関連付けられた文字列のコピーを取得する。(Unicode)

GlobalGetAtomNameW nAtom, lpBuffer, nSize

nAtom : [int] 型: ATOM 取得する文字列に関連付けられたグローバルアトム。
lpBuffer : [wstr] 型: LPTSTR 文字列用のバッファ。
nSize : [int] 型: int バッファのサイズ（文字数）。

(プラグイン / モジュール : kernel32.dll)

解説

指定したグローバルアトムに関連付けられた文字列のコピーを取得する。(Unicode)

[戻り値]
型: UINT 関数が成功した場合、戻り値はバッファにコピーされた文字列の長さ（文字数）で、終端 null
文字を含まない。関数が失敗した場合、戻り値は 0。拡張エラー情報を取得するには GetLastError を呼ぶ。

[備考]
整数アトム（値が 0x0001 から 0xBFFF の範囲内のアトム）に対して返される文字列は null
終端文字列で、最初の文字はポンド記号 (#) で、残りの文字は符号なし整数アトム値を表す。セキュリティに関する考慮事項
この関数を誤って使用するとプログラムのセキュリティを損なう可能性がある。この関数の誤った使用には、lpBuffer
パラメータのサイズを正しく指定しないことが含まれる。また、グローバルアトムは誰でもアクセス可能であるため、その内容のプライバシーと完全性は保証されないことに注意する。
> [!NOTE] > winbase.h ヘッダは GlobalGetAtomName を、UNICODE
プリプロセッサ定数の定義に基づいて ANSI または Unicode
版を自動選択するエイリアスとして定義する。エンコーディング中立なエイリアスとそうでないコードを混在させると、コンパイルや実行時のエラーを引き起こす不一致が生じうる。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照。

情報