FindAtom

Declare Function Api_FindAtom% Lib "kernel32" Alias "FindAtomA" (ByVal lpString$)

Declare Function FindAtom Lib "kernel32" Alias "FindAtomA" (ByVal lpString As String) As Integer

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

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

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

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

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

    位ワードがこの範囲内にない場合、この関数は失敗する。