EnumResourceTypesA 関数 (winbase.h)
バイナリ モジュール内のリソースの種類を列挙します。 Windows Vista 以降、これは通常、 言語に依存しないポータブル実行可能ファイル (LN ファイル) であり、列挙には、ローカライズ可能な言語リソースを含む対応する言語固有のリソース ファイル (.mui ファイル) のいずれか (存在する場合) のリソースも含まれます。 hModule を使用して .mui ファイルを指定することもできます。この場合、そのファイルのみがリソースの種類で検索されます。
または、アプリケーションで EnumResourceTypesEx を呼び出すことができます。これにより、列挙するリソース ファイルをより正確に制御できます。
構文
BOOL EnumResourceTypesA(
[in, optional] HMODULE hModule,
[in] ENUMRESTYPEPROCA lpEnumFunc,
[in] LONG_PTR lParam
);
パラメーター
[in, optional] hModule
種類: HMODULE
検索するモジュールへのハンドル。 このハンドルは 、LoadLibrary または LoadLibraryEx を使用して取得する必要があります。
詳細については、「解説」を参照してください。
このパラメーターが NULL の場合、これは、現在のプロセスの作成に使用されるモジュールにハンドルを渡すことと同じです。
[in] lpEnumFunc
型: ENUMRESTYPEPROC
列挙されたリソースの種類ごとに呼び出されるコールバック関数へのポインター。 詳細については、 EnumResTypeProc 関数を参照してください。
[in] lParam
種類: LONG_PTR
コールバック関数に渡されるアプリケーション定義の値。
戻り値
種類: BOOL
成功した場合は TRUE を 返します。それ以外の場合は FALSE。 詳細なエラー情報を得るには、GetLastError を呼び出します。
解説
検出されたリソースの種類ごとに、 EnumResourceTypes はアプリケーション定義のコールバック関数 lpEnumFunc を呼び出し、検索する各リソースの種類と、 EnumResourceTypes に渡されたその他のさまざまなパラメーターを渡します。
EnumResourceTypes は、 コールバック関数が FALSE を 返すか、すべてのリソースの種類が列挙されるまで、リソースの種類を列挙し続けます。
Windows Vista 以降では、 hModule で LN ファイルが指定されている場合、列挙される型は LN ファイルおよびそれに関連付けられている .mui ファイルに存在するリソースに対応します。 .mui ファイルが見つからない場合は、LN ファイルの型のみが返されます。 .mui ファイルが検索される順序は、通常のリソース ローダーの検索順序です。詳細については、「 ユーザー インターフェイス言語管理 」を参照してください。 1 つの適切な .mui ファイルが見つかった後、1 つの LN ファイルに対応するすべての .mui ファイルのリソースの種類が同じであるため、LN ファイルに関連付けられている他の .mui ファイルに対する検索は続行されません。
列挙に重複が含まれることはありません。特定のリソースの種類が LN ファイルと .mui ファイルの両方に含まれている場合、型は 1 回だけ列挙されます。
例
例については、「 リソース リストの作成」を参照してください。
Note
winbase.h ヘッダーは EnumResourceTypes をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | winbase.h (Windows.h を含む) |
| Library | Kernel32.lib |
| [DLL] | Kernel32.dll |
関連項目
概念
参照