EnumResourceNamesExW

指定されたバイナリモジュールに関連付けられた、指定された種類のリソースを列挙する。検索は LN ファイルと関連する .mui ファイルの両方を含むこともでき、いくつかの方法で制限することもできる。(Unicode)

EnumResourceNamesExW hModule, lpType, lpEnumFunc, lParam, dwFlags, LangId

hModule : [intptr] 型: HMODULE 検索するモジュールへのハンドル。通常これは LN ファイルであり、フラグ RESOURCE_ENUM_MUI が設定されている場合は適切な .mui ファイルも検索に含まれる。あるいは .mui ファイルや別の LN ファイルへのハンドルでもよい。このパラメータが NULL の場合、現在のプロセスを作成するために使用したモジュールへのハンドルを渡すのと同等である。
lpType : [wstr] 型: LPCTSTR 名前を列挙するリソースの種類。あるいは、ポインタの代わりに MAKEINTRESOURCE(ID) を指定できる。ID は事前定義リソース種別を表す整数値。事前定義リソース種別の一覧は Resource Types を参照。詳細は以下の Remarks セクションを参照。
lpEnumFunc : [int] 型: ENUMRESNAMEPROC 列挙された各リソース名に対して呼び出されるコールバック関数へのポインタ。詳細は EnumResNameProc を参照。
lParam : [int] 型: LONG_PTR コールバック関数に渡すアプリケーション定義の値。このパラメータはエラーチェックに使用できる。
dwFlags : [int] 型: DWORD 検索するファイルの種類。次の値がサポートされている。dwFlags が 0 の場合、RESOURCE_ENUM_LN と RESOURCE_ENUM_MUI フラグが指定されているとみなされる。
LangId : [int] 型: LANGID MUI モジュール内の検索をフィルタリングするためのローカリゼーション言語。このパラメータは dwFlags に RESOURCE_ENUM_MUI フラグが設定されている場合にのみ使用される。0 を指定した場合、現在の言語設定に一致するすべての .mui ファイルが、通常のリソースローダー戦略（User Interface Language Management を参照）に従って検索に含まれる。0 以外の LangId が指定された場合、指定された LangId に一致する .mui ファイルだけが検索される。

(プラグイン / モジュール : kernel32.dll)

解説

指定されたバイナリモジュールに関連付けられた、指定された種類のリソースを列挙する。検索は LN ファイルと関連する .mui
ファイルの両方を含むこともでき、いくつかの方法で制限することもできる。(Unicode)

[戻り値]
型: BOOL 成功した場合は TRUE、関数が指定された種類のリソースを見つけられなかったり他の理由で失敗した場合は FALSE
を返す。拡張エラー情報を取得するには GetLastError を呼ぶ。

[備考]
IS_INTRESOURCE(lpszType) が TRUE の場合、lpszType
は指定されたリソース種別の整数識別子を指定する。それ以外の場合は NULL 終端文字列へのポインタである。文字列の最初の文字がポンド記号
(#) の場合、残りの文字はリソース種別の整数識別子を指定する 10 進数を表す。たとえば、文字列 "#258" は識別子 258
を表す。列挙検索は LN ファイルと関連する .mui
ファイルの両方を含むことができる。任意の種類の単一バイナリモジュールに制限することもできる。単一の LN ファイルに関連する .mui
ファイルに制限することもできる。hModule パラメータに LN ファイルを指定し、0 以外の LangId
パラメータを指定することで、その LN ファイルと言語に関連する一意の .mui
ファイルに検索を制限することができる。見つかったリソースごとに、EnumResourceNamesEx
はアプリケーション定義のコールバック関数 lpEnumFunc を呼び、見つかった各リソースの名前または ID
と、EnumResourceNamesEx に渡されたその他のパラメータを渡す。リソースに ID がある場合、ID
がコールバック関数に返される。それ以外の場合、リソース名がコールバック関数に返される。詳細は EnumResNameProc
を参照。EnumResourceNamesEx 関数は、コールバック関数が FALSE
を返すか、この種類のすべてのリソース名が列挙されるまで、リソース名の列挙を続ける。hModule が LN
ファイルを指定し、両方のフラグが選択されている場合、列挙される名前は LN ファイル内または関連する .mui
ファイル内に存在するリソースに対応する。.mui ファイルが見つからない場合、LN ファイルからの名前のみが返される。1 つの適切な
.mui ファイルが見つかると、それ以降は検索されない。これは、単一の LN ファイルに対応するすべての .mui
ファイルが同じリソース名を持っているためである。dwFlags と LangId の両方が 0 の場合、関数は
EnumResourceNames と同様に動作する。LangId が 0 以外の場合、その言語識別子に対応する .mui
ファイルのみが検索される。言語フォールバックは使用されない。その言語の .mui
ファイルが存在しない場合、列挙は空になる（その言語のリソースが LN ファイル内に存在し、LN
ファイルも検索するフラグが設定されている場合を除く）。列挙には重複は含まれない。特定の言語のリソースが LN ファイルと .mui
ファイルの両方に含まれている場合、名前は 1 度だけ列挙される。

情報