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
要搜尋之模組的句柄。 此句柄必須透過 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 檔案的順序是一般的資源載入器搜尋順序;如需詳細資訊 ,請參閱使用者介面語言管理 。 找到一個適當的 .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 |
另請參閱
概念
參考