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

関連項目

概念

EnumResTypeProc

EnumResourceLanguages

EnumResourceNames

EnumResourceTypesEx

参照

リソース