決定在指定模組中具有指定類型、名稱及語言的資源位置。
語法
HRSRC FindResourceExW(
[in, optional] HMODULE hModule,
[in] LPCWSTR lpType,
[in] LPCWSTR lpName,
[in] WORD wLanguage
);
參數
[in, optional] hModule
類型: HMODULE
模組的控制碼,其可攜式可執行檔或隨附的 MUI 檔案包含資源。 如果此參數為 Null,則函式會搜尋用來建立現行處理程序的模組。
[in] lpType
類型:LPCTSTR
資源類型。 或者,此參數可以是 MAKEINTRESOURCE(ID) ,而不是指標,其中 ID 是給定資源類型的整數 ID。 如需標準資源類型,請參閱 資源類型。 如需詳細資訊,請參閱下面的一節。
[in] lpName
類型:LPCTSTR
資源名稱。 或者,此參數可以是 MAKEINTRESOURCE(ID) ,而不是指標,其中 ID 是資源的整數 ID。 如需詳細資訊,請參閱下面的一節。
[in] wLanguage
類型: WORD
資源的語言。 如果此參數是 MAKELANGID(LANG_NEUTRAL, SUBLANG_NEUTRAL),則會使用與呼叫執行緒相關聯的現行語言。
若要指定現行語言以外的語言,請使用 MAKELANGID 巨集來建立此參數。 如需相關資訊,請參閱 MAKELANGID。
返回值
類型: HRSRC
如果函式成功,傳回值是指定資源資訊區塊的控制碼。 若要取得資源的控制碼,請將此控制碼傳遞至 LoadResource 函式。
如果函式失敗,傳回值為 NULL。 若要取得擴充的錯誤資訊,請呼叫 GetLastError。
備註
如果 x = lpType 或 lpName 的 IS_INTRESOURCE 為 TRUE,則 x 會指定指定資源類型或名稱的整數識別碼。 否則,這些參數是以 Null 結尾字串的長指標。 如果字串的第一個字元是井號 (#) ,則其餘字元代表十進位數,指定資源名稱或類型的整數識別碼。 例如,字串「#258」代表整數識別碼 258。
若要減少資源所需的記憶體量,應用程式應該以整數識別碼來參考它,而不是依名稱來參考它。
應用程式可以使用 FindResourceEx 來尋找任何類型的資源,但只有在應用程式必須存取二進位資源數據時,才應該使用這個函式,方法是後續呼叫 LoadResource ,然後呼叫 LockResource。
若要立即使用資源,應用程式應該使用下列其中一個資源特定函式來尋找資源,並將資料轉換成更可用的形式。
| 功能 | 行動 |
|---|---|
| 格式訊息 | 載入並格式化訊息表格項目。 |
| 負載加速器 | 載入加速器表格。 |
| 載入點陣圖 | 載入點陣圖資源。 |
| 載入游標 | 載入游標資源。 |
| 載入圖示 | 載入圖示資源。 |
| 載入功能表 | 載入功能表資源。 |
| 載入字串 | 載入字串資料表項目。 |
例如,應用程式可以使用 LoadIcon 函式來載入圖示以在螢幕上顯示。 不過,如果應用程式正在載入圖示,將其數據複製到另一個應用程式,則應該使用 FindResourceEx 和 LoadResource 。
字串資源儲存在每個區段最多 16 個字串的區段中。 每個區段中的字串會儲存為計數 (不一定以 Null 結尾) Unicode 字串的序列。 LoadString 函式會從其對應的區段擷取字串資源。
需求
| Requirement | 價值觀 |
|---|---|
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 支援的最低伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平臺 | 窗戶 |
| Header | libloaderapi.h (包括 Windows.h) |
| Library | 內核32。圖書館 |
| DLL | Kernel32.dll |
另請參閱
尋找資源
格式訊息
IS_INTRESOURCE
負載加速器
載入點陣圖
載入游標
載入圖示
載入功能表
載入資源
載入字串
馬克蘭吉德
其他資源
參考
資源