EnumResourceLanguagesExW 関数 (libloaderapi.h)
指定したバイナリ モジュールに関連付けられた、指定した型と名前の言語固有のリソースを列挙します。 列挙型をより詳細に制御できるようにすることで 、EnumResourceLanguages を拡張します。
構文
BOOL EnumResourceLanguagesExW(
[in] HMODULE hModule,
[in] LPCWSTR lpType,
[in] LPCWSTR lpName,
[in] ENUMRESLANGPROCW lpEnumFunc,
[in] LONG_PTR lParam,
[in] DWORD dwFlags,
[in] LANGID LangId
);
パラメーター
[in] hModule
種類: HMODULE
検索するモジュールへのハンドル。 通常、これは 言語に依存しないポータブル実行可能ファイル (LN ファイル) であり、フラグ RESOURCE_ENUM_MUI が設定されている場合は、適切な .mui ファイルが検索に含まれます。 または、.mui ファイルまたはその他の LN ファイルへのハンドルを指定することもできます。 これが特定の .mui ファイルの場合、そのファイルのみがリソースを検索します。
このパラメーターが NULL の場合、現在のプロセスの作成に使用されるモジュールにハンドルを渡すのと同じです。
[in] lpType
種類: LPCTSTR
言語が列挙されるリソースの種類。 または、ポインターではなく、このパラメーターに MAKEINTRESOURCE(ID) を指定できます。ここで、ID は定義済みのリソースの種類を表す整数値です。 定義済みのリソースの種類の一覧については、「 リソースの種類」を参照してください。 詳細情報
詳細については、以下の「解説」セクションを参照してください。
[in] lpName
種類: LPCTSTR
言語が列挙されているリソースの名前。 または、ポインターではなく、このパラメーターに MAKEINTRESOURCE(ID) を指定できます。ここで、ID はリソースの整数識別子です。 詳細については、以下の「解説」セクションを参照してください。
[in] lpEnumFunc
型: ENUMRESLANGPROC
列挙されたリソース言語ごとに呼び出されるコールバック関数へのポインター。 詳細については、「 EnumResLangProcW」を参照してください。
[in] lParam
種類: LONG_PTR
コールバック関数に渡されるアプリケーション定義の値。 このパラメーターは、エラー チェックで使用できます。
[in] dwFlags
型: DWORD
検索するファイルの種類。 次の値がサポートされています。 dwFlags が 0 の場合、RESOURCE_ENUM_LNフラグとRESOURCE_ENUM_MUI フラグが指定されていると見なされることに注意してください。
[in] LangId
種類: LANGID
.mui ファイル内の検索をフィルター処理するために使用されるローカライズ言語。 このパラメーターは、dwFlags でRESOURCE_ENUM_MUI フラグが設定されている場合にのみ使用されます。 0 を指定すると、すべての .mui ファイルが検索に含まれます。 0 以外の LangId が 指定されている場合、検索される .mui ファイルは、指定した LangId に一致するものだけです。
戻り値
種類: BOOL
関数が成功した場合は TRUE、指定された型のリソースが関数で見つからない場合は FALSE、別の理由で関数が失敗した場合は TRUE を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。
解説
IS_INTRESOURCE(lpType) が TRUE の場合、lpType は指定されたリソースの種類の整数識別子を指定します。 それ以外の場合は、null で終わる文字列へのポインターです。 文字列の最初の文字がシャープ記号 (#)の場合、残りの文字は を指定する 10 進数を表します。
リソースの種類の整数識別子。 たとえば、文字列 "#258" は識別子 258 を表します。
同様に、 IS_INTRESOURCE(lpName) が TRUE の場合、 lpName は指定されたリソースの整数識別子を指定します。 それ以外の場合は、null で終わる文字列へのポインターです。 文字列の最初の文字がシャープ記号 (#)の場合、残りの文字は を指定する 10 進数を表します。
リソースの整数識別子。
Windows Vista 以降、バイナリ モジュールは通常 LN ファイルであり、列挙にはローカライズ可能な言語リソースを含む対応する言語固有のリソース ファイル (.mui ファイル) からのリソースも含まれます。
このようなリソースが検出されるたびに、 EnumResourceLanguagesEx はアプリケーション定義のコールバック関数 lpEnumFunc を呼び出し、コールバック関数にリソースが見つかった言語の言語識別子 ( 「言語識別子」を参照) と EnumResourceLanguagesEx に渡されたその他のさまざまなパラメーターを渡します。
検索には、LN ファイルとそれに関連付けられている .mui ファイルの両方を含めることができます。または、任意の種類の 1 つのバイナリ モジュール、または 1 つの LN ファイルに関連付けられている .mui ファイルのいずれかに制限できます。 また、 hModule パラメーターに LN ファイルを指定し、0 以外の LangId パラメーターを指定すると、その LN ファイルと言語に関連付けられている一意の .mui ファイルに検索を制限できます。
EnumResourceLanguagesEx 関数は、コールバック関数が FALSE を返すか、すべてのリソース言語が列挙されるまで、リソース言語を列挙し続けます。
hModule で LN ファイルが指定され、両方のフラグが選択されている場合、列挙される言語には、リソースが LN ファイルまたはそれに関連付けられている .mui ファイルのいずれかに存在するすべての言語が含まれます。 .mui ファイルが見つからない場合は、LN ファイルの言語のみが返されます。
dwFlags にRESOURCE_ENUM_MUIまたは NULL が含まれており、LangId が 0 の場合、列挙型にはまず、EnumUILanguages から取得した言語を使用して、システムにインストールされているすべての .mui ファイルに関連付けられている言語が含まれます。 最後に、 RESOURCE_ENUM_LN フラグも設定されている場合は、 hModule で指定されたファイルも検索されます。
LangId が 0 以外の場合は、その言語識別子に対応する .mui ファイルのみが検索されます。 言語フォールバックは使用されません。 その言語の .mui ファイルが存在しない場合、列挙は空になります (その言語のリソースが LN ファイルに存在し、LN ファイルも検索するように フラグが設定されている場合を除きます)。
列挙には重複が含まれることはありません。特定の言語のリソースが LN ファイルと .mui ファイルの両方に含まれている場合、型は 1 回だけ列挙されます。
例
例については、「 リソース リストの作成」を参照してください。
注意
libloaderapi.h ヘッダーは、EnumResourceLanguagesEx をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | libloaderapi.h (Windows.h を含む) |
Library | Kernel32.lib |
[DLL] | Kernel32.dll |
関連項目
概念
リファレンス