GlobalGetAtomNameA 関数 (winbase.h)
指定したグローバル アトムに関連付けられている文字列のコピーを取得します。
構文
UINT GlobalGetAtomNameA(
[in] ATOM nAtom,
[out] LPSTR lpBuffer,
[in] int nSize
);
パラメーター
[in] nAtom
種類: ATOM
取得する文字列に関連付けられているグローバル アトム。
[out] lpBuffer
種類: LPTSTR
文字列のバッファー。
[in] nSize
型: int
バッファーのサイズ (文字単位)。
戻り値
型: UINT
関数が成功した場合、戻り値はバッファーにコピーされた文字列の長さ (文字単位) であり、終端の null 文字は含まれません。
関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。
解説
整数の原子 (値が 0x0001 0xBFFF の範囲内にある atom) に対して返される文字列は null で終わる文字列で、最初の文字はポンド記号 (#) で、残りの文字は符号なし整数値を表します。
セキュリティに関する考慮事項
この関数を誤って使用すると、プログラムのセキュリティが損なわれる可能性があります。 この関数の誤った使用には、 lpBuffer パラメーターのサイズを正しく指定しないことが含まれます。 また、グローバル原子は誰でもアクセス可能であることに注意してください。したがって、プライバシーとその内容の整合性は保証されません。Note
winbase.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして GlobalGetAtomName を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | winbase.h (Windows.h を含む) |
| Library | Kernel32.lib |
| [DLL] | Kernel32.dll |
関連項目
参照