GlobalGetAtomNameW 関数 (winbase.h)

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

構文

UINT GlobalGetAtomNameW(
  [in]  ATOM   nAtom,
  [out] LPWSTR lpBuffer,
  [in]  int    nSize
);

パラメーター

[in] nAtom

型: ATOM

取得する文字列に関連付けられているグローバル アトム。

[out] lpBuffer

型: LPTSTR

文字列のバッファー。

[in] nSize

型: int

バッファーのサイズ (文字数)。

戻り値

型: UINT

関数が成功した場合、戻り値はバッファーにコピーされた文字列の長さ (終端の null 文字は含まれません) です。

関数が失敗した場合、戻り値は 0 です。 拡張エラー情報を取得するには、GetLastError呼び出します。

備考

整数のアトム (値が 0x0001 から 0xBFFF の範囲内にある atom) に対して返される文字列は null で終わる文字列で、最初の文字はシャープ記号 (#) で、残りの文字は符号なし整数値を表します。

セキュリティに関する考慮事項

この関数を誤って使用すると、プログラムのセキュリティが損なわれる可能性があります。 この関数の不適切な使用には、lpBuffer パラメーターのサイズを正しく指定しないことが含まれます。 また、グローバルアトムは誰でもアクセス可能であることに注意してください。したがって、プライバシーとその内容の整合性は保証されません。

手記

winbase.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして GlobalGetAtomName を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー	Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	winbase.h (Windows.h を含む)
ライブラリ	Kernel32.lib
DLL	Kernel32.dll

関連項目

AddAtom を する

DeleteAtom の

FindAtom を する

GlobalAddAtom の

GlobalDeleteAtom

GlobalFindAtom

MAKEINTATOM を する

リファレンス