EnumResourceNamesW 関数 (libloaderapi.h)
バイナリ モジュール内の指定した型のリソースを列挙します。 Windows Vista 以降の場合、これは通常、言語に依存しないポータブル実行可能 (LN ファイル) であり、列挙には、ローカライズ可能な言語リソースを含む対応する言語固有のリソース ファイル (.mui ファイル) のリソースも含まれます。 hModule を して .mui ファイルを指定することもできます。その場合、そのファイルのみがリソースを検索します。
構文
BOOL EnumResourceNamesW(
[in, optional] HMODULE hModule,
[in] LPCWSTR lpType,
[in] ENUMRESNAMEPROCW lpEnumFunc,
[in] LONG_PTR lParam
);
パラメーター
[in, optional] hModule
型: HMODULE
検索するモジュールへのハンドル。 Windows Vista 以降では、これが LN ファイルの場合は、適切な .mui ファイル (存在する場合) が検索に含まれます。
このパラメーターが NULL 場合、これは、現在のプロセスの作成に使用されるモジュールにハンドルを渡すことと同じです。
[in] lpType
型: LPCTSTR
名前が列挙されているリソースの種類。 または、ポインターではなく、このパラメーターを MAKEINTRESOURCE (ID)できます。ここで、ID は定義済みのリソースの種類を表す整数値です。 定義済みのリソースの種類の一覧については、「リソースの種類の 参照してください。 詳細については、後述の「解説」セクションを参照してください。
[in] lpEnumFunc
型: ENUMRESNAMEPROC
列挙されたリソース名または ID ごとに呼び出されるコールバック関数へのポインター。 詳細については、ENUMRESNAMEPROC を参照してください。
[in] lParam
型: LONG_PTR
コールバック関数に渡されるアプリケーション定義の値。 このパラメーターは、エラー チェックで使用できます。
戻り値
型: BOOL
戻り値は、関数が成功した場合、または指定された型のリソースが見つからない場合、または別の理由で関数が失敗した場合に FALSE を 場合は TRUE 。 拡張エラー情報を取得するには、GetLastError 呼び出します。
備考
IS_INTRESOURCE(lpszType) が TRUE 場合、lpszType 指定されたリソースの種類の整数識別子を指定します。 それ以外の場合は、null で終わる文字列へのポインターです。 文字列の最初の文字がシャープ記号 (#)の場合、残りの文字はリソースの種類の整数識別子を指定する 10 進数を表します。 たとえば、文字列 "#258" は識別子 258 を表します。
見つかったリソースごとに、EnumResourceNames は、lpEnumFunc アプリケーション定義のコールバック関数を呼び出し、検索する各リソースの名前または ID、および EnumResourceNamesに渡されたその他のさまざまなパラメーターを渡します。 渡された名前はコールバック内でのみ有効です。渡された名前が文字列ポインターの場合は、すべてのコールバック呼び出しに再利用される内部バッファーを指します。
または、アプリケーションは EnumResourceNamesEx 呼び出すことができます。これによって、列挙されるリソースをより正確に制御できます。
リソースに ID がある場合、ID はコールバック関数に渡されます。それ以外の場合は、リソース名がコールバック関数に渡されます。 詳細については、ENUMRESNAMEPROC を参照してください。
EnumResourceNames 関数は、コールバック関数が FALSE 返すか、すべてのリソースが列挙されるまで、リソースを列挙し続けます。
Windows Vista 以降では、hModule LN ファイルが指定されている場合、列挙されたリソースは LN ファイル内またはそれに関連付けられている .mui ファイル内に存在できます。 .mui ファイルが見つからない場合は、LN ファイルのリソースのみが返されます。 .mui ファイルが検索される順序は、通常のリソース ローダーの検索順序です。詳細については、「ユーザー インターフェイス言語管理の」を参照してください。 適切な .mui ファイルが 1 つ見つかると、.mui ファイルの検索が停止します。 1 つの LN ファイルに対応するすべての .mui ファイルには同じリソースの種類があるため、見つかった .mui ファイル内のリソースのみを列挙する必要があります。
列挙に重複が含まれることはありません。同じ名前のリソースが LN ファイルと .mui ファイルの両方に含まれている場合、リソースは 1 回だけ列挙されます。
例
例については、「リソース リストの作成」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされる最小サーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| ターゲット プラットフォーム の | ウィンドウズ |
| ヘッダー | libloaderapi.h (Windows.h を含む) |
| ライブラリ | Kernel32.lib |
| DLL | Kernel32.dll |