FindAtomA 関数 (winbase.h)

  • [アーティクル]

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

構文

ATOM FindAtomA(
  [in] LPCSTR lpString
);

パラメーター

[in] lpString

型: LPCTSTR

検索対象の文字列。

または、 MAKEINTATOM マクロを使用して変換された整数原子を使用することもできます。 詳細については、「解説」を参照してください。

戻り値

種類: ATOM

関数が成功した場合、戻り値は指定された文字列に関連付けられた atom です。

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

システムでは atom テーブル内の文字列の大文字と小文字が保持されますが、 FindAtom 関数によって実行される検索では大文字と小文字は区別されません。

makeINTATOM マクロによって lpString が作成された場合、下位ワードは0xBFFF 0x0001範囲内にある必要があります。 下位ワードがこの範囲にない場合、関数は失敗します。

注意

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

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー winbase.h (Windows.h を含む)
Library Kernel32.lib
[DLL] Kernel32.dll

関連項目

AddAtom

DeleteAtom

GlobalAddAtom

GlobalDeleteAtom

GlobalFindAtom

参照