共用方式為

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 為零，則會假設指定 RESOURCE_ENUM_LN 和 RESOURCE_ENUM_MUI 旗標。

價值 意義
RESOURCE_ENUM_MUI
0x0002
 在與 hModule所指定 LN 檔案相關聯的 .mui 檔案中搜尋語言特定資源。 或者，如果 LangId 為非零，則搜尋的唯一 .mui 檔案會是符合指定 LangId。 通常只有在 hModule 參考 LN 檔案時，才應該使用此旗標。 如果 hModule 參考 .mui 檔案，則該檔案實際上會由 RESOURCE_LN 旗標所涵蓋，儘管旗標的名稱。 如需搜尋順序，請參閱下方的一節。
RESOURCE_ENUM_LN
0x0001
 搜尋由 hModule所指定的檔案，不論檔案是 LN 檔案、另一種 LN 檔案或 .mui 檔案。
RESOURCE_ENUM_MUI_SYSTEM
0x0004
 將 .mui 檔案搜尋限制為系統安裝的 MUI 語言。
RESOURCE_ENUM_VALIDATE
0x0008
 在執行 列舉時，對資源區段及其參考執行額外的驗證，以確保資源已正確格式化。

[in] LangId

類型：LANGID

用來篩選 .mui 檔案中搜尋的當地語系化語言。 只有在 dwFlags中設定 RESOURCE_ENUM_MUI 旗標時，才會使用此參數。 如果指定零，則搜尋中會包含所有 .mui 檔案。 如果指定了非零 LangId，則搜尋的唯一 .mui 檔案會是符合指定 LangId。

傳回值

類型：BOOL

如果函式成功或 FALSE 函式找不到指定之類型的資源，或函式因其他原因而失敗，則傳 回 true TRUE。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

言論

如果 IS_INTRESOURCE（lpType） TRUE，則 lpType 指定指定資源類型的整數標識符。 否則，它是以 Null 結尾字串的指標。 如果字串的第一個字元是磅號 （#），則其餘字元代表指定的十進位數

資源類型的整數標識碼。 例如，字串 “#258” 代表標識碼 258。

同樣地，如果 IS_INTRESOURCE（lpName） TRUE，則 lpName 指定指定資源的整數標識碼。 否則，它是以 Null 結尾字串的指標。 如果字串的第一個字元是磅號 （#），則其餘字元代表指定的十進位數

資源的整數標識碼。

從 Windows Vista 開始，二進位模組通常是 LN 檔案，列舉也會包含包含可當地語系化語言資源的對應語言特定資源檔 （.mui 檔案） 的資源。

針對找到的每個這類資源，EnumResourceLanguagesEx 呼叫應用程式定義的回呼函式 lpEnumFunc，傳遞至回呼函式語言標識符（請參閱 語言標識符），該語言是找到資源的語言（以及傳遞給 EnumResourceLanguagesEx的各種其他參數）。

搜尋可以同時包含 LN 檔案及其相關聯的 .mui 檔案，也可以限制為任何類型的單一二進位模組，或限制為與單一 LN 檔案相關聯的 .mui 檔案。 此外，藉由指定 hModule 參數和非零 LangId 參數的 LN 檔案，搜尋可以限制為與該 LN 檔案和語言相關聯的唯一 .mui 檔案。

EnumResourceLanguagesEx 函式會繼續列舉資源語言，直到回呼函式傳回 FALSE 或所有資源語言都已列舉為止。

如果 hModule 指定 LN 檔案，而且選取這兩個旗標，則列舉的語言會包含資源位於 LN 檔案或與其相關聯的任何 .mui 檔案中的所有語言。 如果找不到 .mui 檔案，則只會傳回 LN 檔案中的語言。

如果 dwFlags 包含 RESOURCE_ENUM_MUI 或 NULL，且 LangId 為 0，則列舉會先包含與所有系統安裝 .mui 檔案相關聯的語言，並使用從 EnumUILanguages擷取的語言。 最後，如果同時設定 RESOURCE_ENUM_LN 旗標，也會搜尋由 hModule 所指定的檔案。

如果 LangId 為非零，則只會搜尋對應至該語言識別碼的 .mui 檔案。 將不會使用語言後援。 如果該語言的 .mui 檔案不存在，列舉將會是空的（除非該語言的資源存在於 LN 檔案中，而且旗標也會設定為搜尋 LN 檔案）。

列舉永遠不會包含重複專案：如果特定語言的資源同時包含在 LN 檔案和 .mui 檔案中，則類型只會列舉一次。

例子

如需範例，請參閱 建立資源清單。

注意

libloaderapi.h 標頭會根據 UNICODE 預處理器常數的定義，將 EnumResourceLanguagesEx 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 libloaderapi.h （包括 Windows.h）
連結庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

概念

EnumResLangProcW

EnumResourceNamesEx

EnumResourceTypesEx

MAKEINTRESOURCE

參考

資源