FindAtomW 関数 (winbase.h)

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

構文

ATOM FindAtomW(
  [in] LPCWSTR lpString
);

パラメーター

[in] lpString

種類: LPCTSTR

検索する文字列。

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

戻り値

種類: ATOM

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

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

解説

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

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

注意

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

要件

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

関連項目

AddAtom

DeleteAtom

GlobalAddAtom

GlobalDeleteAtom

GlobalFindAtom

参照