GetAtomNameW

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

GetAtomNameW 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 ヘッダでは GetAtomName が、UNICODE
プリプロセッサ定数の定義に応じて自動的にこの関数の ANSI 版または Unicode
版を選択するエイリアスとして定義されている。エンコーディング中立のエイリアスをエンコーディング中立でないコードと混在させると、コンパイルエラーや実行時エラーにつながる不一致が発生する可能性がある。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照。

情報