enumResourceTypesA 函式 (winbase.h)

發行項
06/22/2023

列舉二進位模組內的資源類型。從 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 標頭會將 EnumResourceTypes 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程式碼，可能會導致編譯或執行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

規格需求


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