GlobalFindAtom

Declare Function Api_GlobalFindAtom% Lib "kernel32" Alias "GlobalFindAtomA" (ByVal lpString$)

Declare Function GlobalFindAtom Lib "kernel32" Alias "GlobalFindAtomA" (ByVal lpString As String) As Integer

指定された文字列をグローバルアトムテーブルから検索し、その文字列に関連付けられているグローバルアトムを取得する。

パラメータ

lpString
    ［入力］グローバルアトムテーブルから検索したい、NULL で終わる文字列へのポインタを指定する。
    代わりに、 マクロを使って整数アトムを変換し、得られた文字列を使うこともできる。

戻り値
    関数が成功すると、指定した文字列に関連付けられたグローバルアトムが返る。
    関数が失敗すると、0 が返る。拡張エラー情報を取得するには、 関数を使う。

解説
    システムはアトムテーブル内で大文字と小文字を区別して格納しているが、GlobalFindAtom 関数による文字列の検索の際は、大文字と

    小文字を区別しない。
    マクロを使って lpString を作成した場合、下位ワード（low-order word）は必ず 0x0001〜0xBFFF の範囲にある。下位ワードがこの範

    囲内にない場合、この関数は失敗する。