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 檔案的順序是一般資源載入器搜尋順序;如需詳細資訊,請參閱 用戶介面語言管理。 找到一個適當的 .mui 檔案之後,搜尋不會繼續至與 LN 檔案相關聯的其他 .mui 檔案,因為對應至單一 LN 檔案的所有 .mui 檔案具有相同的資源類型集。
列舉永遠不會包含重複專案:如果指定的資源類型同時包含在 LN 檔案和 .mui 檔案中,則類型只會列舉一次。
例子
如需範例,請參閱 建立資源清單。
注意
winbase.h 標頭會根據 UNICODE 預處理器常數的定義,將 EnumResourceTypes 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱函式原型的
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
支援的最低伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平臺 | 窗戶 |
標頭 | winbase.h (包括 Windows.h) |
連結庫 | Kernel32.lib |
DLL | Kernel32.dll |
另請參閱
概念
參考