共用方式為


enumResourceTypesW 函式 (winbase.h)

列舉二進位模組內的資源類型。 從 Windows Vista 開始,這通常是 語言中性可 攜式可執行檔 (LN 檔案) ,而且列舉也包含其中一個對應語言特定資源檔的資源, (.mui 檔案) ,如果有的話,則包含可本地化的語言資源。 您也可以使用 hModule 來指定 .mui 檔案,在此情況下,只會搜尋該檔案的資源類型。

或者,應用程式可以呼叫 EnumResourceTypesEx,以更精確地控制要列舉的資源檔。

語法

BOOL EnumResourceTypesW(
  [in, optional] HMODULE          hModule,
  [in]           ENUMRESTYPEPROCW lpEnumFunc,
  [in]           LONG_PTR         lParam
);

參數

[in, optional] hModule

類型: HMODULE

要搜尋之模組的句柄。 此句柄必須透過 LoadLibraryLoadLibraryEx 取得。

如需詳細資訊,請參閱「備註」。

如果此參數為 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 檔案的順序是一般的資源載入器搜尋順序;如需詳細資訊 ,請參閱使用者介面語言管理 。 找到一個適當的 .mui 檔案之後,搜尋不會繼續進行與 LN 檔案相關聯的其他 .mui 檔案,因為對應至單一 LN 檔案的所有 .mui 檔案都有相同的資源類型集。

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

範例

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

注意

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

規格需求

需求
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 winbase.h (包含 Windows.h)
程式庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

概念

EnumResTypeProc

EnumResourceLanguages

EnumResourceNames

EnumResourceTypesEx

參考

資源