共用方式為


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

要搜尋之模組的控制碼。 此控制碼必須透過 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 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 winbase.h (包含 Windows.h)
程式庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

概念

EnumResTypeProc

EnumResourceLanguages

EnumResourceNames

EnumResourceTypesEx

參考

資源