EnumResourceLanguagesA 関数 (winbase.h)

[アーティクル]
06/27/2024

バイナリモジュールに関連付けられている、指定した型と名前の言語固有のリソースを列挙します。

構文

BOOL EnumResourceLanguagesA(
  [in] HMODULE          hModule,
  [in] LPCSTR           lpType,
  [in] LPCSTR           lpName,
  [in] ENUMRESLANGPROCA lpEnumFunc,
  [in] LONG_PTR         lParam
);

パラメーター

[in] hModule

型: HMODULE

検索するモジュールへのハンドル。 Windows Vista 以降では、言語に依存しないポータブル実行可能ファイル (LN ファイル) の場合は、適切な .mui ファイル (存在する場合) が検索に含まれます。これが特定の .mui ファイルの場合、そのファイルのみがリソースを検索します。

このパラメーターが NULL場合、これは、現在のプロセスの作成に使用されるモジュールにハンドルを渡すことと同じです。

[in] lpType

型: LPCTSTR

言語が列挙されているリソースの種類。または、ポインターではなく、このパラメーターを MAKEINTRESOURCE(ID) できます。ここで、ID は定義済みのリソースの種類を表す整数値です。定義済みのリソースの種類の一覧については、「リソースの種類の参照してください。詳細については、以下の「解説」セクションを参照してください。

[in] lpName

型: LPCTSTR

言語が列挙されているリソースの名前。または、ポインターではなく、このパラメーターを MAKEINTRESOURCE(ID) できます。ここで、ID はリソースの整数識別子です。詳細については、以下の「解説」セクションを参照してください。

[in] lpEnumFunc

型: ENUMRESLANGPROC

列挙されたリソース言語ごとに呼び出されるコールバック関数へのポインター。詳細については、「EnumResLangProcAをする」を参照してください。

[in] lParam

型: LONG_PTR

コールバック関数に渡されるアプリケーション定義の値。このパラメーターは、エラーチェックで使用できます。

戻り値

型: BOOL

成功した場合 TRUE、それ以外の場合は FALSE 返します。拡張エラー情報を取得するには、GetLastError呼び出します。

備考

IS_INTRESOURCE(lpType) が TRUE場合、lpType は、指定されたリソースの種類の整数識別子を指定します。それ以外の場合は、null で終わる文字列へのポインターです。文字列の最初の文字がシャープ記号 (#)の場合、残りの文字はリソースの種類の整数識別子を指定する 10 進数を表します。たとえば、文字列 "#258" は識別子 258 を表します。

同様に、IS_INTRESOURCE(lpName) が TRUE場合、lpName 指定されたリソースの整数識別子が指定されます。それ以外の場合は、null で終わる文字列へのポインターです。文字列の最初の文字がシャープ記号 (#)の場合、残りの文字はリソースの整数識別子を指定する 10 進数を表します。

Windows Vista 以降、バイナリモジュールは通常、言語に依存しないポータブル実行可能ファイル (LN ファイル) であり、列挙には、ローカライズ可能な言語リソースを含む対応する言語固有のリソースファイル (.mui ファイル) のリソースも含まれます。

見つかったリソースごとに、enumResourceLanguages は、lpEnumFuncアプリケーション定義コールバック関数を呼び出し、リソースが見つかった言語の言語識別子 (言語識別子を参照) と、EnumResourceLanguages渡されたその他のさまざまなパラメーターを渡します。

または、アプリケーションは EnumResourceLanguagesEx を呼び出すことができます。これによって、列挙されるリソースをより正確に制御できます。

EnumResourceLanguages 関数は、コールバック関数が FALSE を返すか、すべてのリソース言語が列挙されるまで、リソース言語列挙し続けます。

Windows Vista 以降では、hModule LN ファイルが指定されている場合、列挙されたリソースは LN ファイル内またはそれに関連付けられている .mui ファイル内に存在できます。 .mui ファイルが見つからない場合は、LN ファイルのリソースのみが返されます。 EnumResourceNames および enumResourceTypesとは異なり、この検索では複数の .mui ファイルが検索されます。列挙体は、EnumUILanguagesに関連付けられているフォルダー .mui ファイルで始まります。これらのファイルの後に、そのパスが MUI リソース管理で説明されているスキームに準拠他の .mui ファイルが続きます。最後に、hModule によって指定ファイルも検索されます。

列挙体に重複が含まれることはありません。同じ名前、種類、言語を持つリソースが LN ファイルと .mui ファイルの両方に含まれている場合、リソースは 1 回だけ列挙されます。

例

例については、「リソースリストの作成」を参照してください。

手記

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

必要条件

要件	価値
サポートされる最小クライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされる最小サーバー	Windows 2000 Server [デスクトップアプリのみ]
ターゲットプラットフォームの	ウィンドウズ
ヘッダー	winbase.h (Windows.h を含む)
ライブラリ	Kernel32.lib
DLL	Kernel32.dll

次の方法で共有

EnumResourceLanguagesA 関数 (winbase.h)

構文

パラメーター

戻り値

備考

例

必要条件

関連項目

フィードバック

その他のリソース