共用方式為


FindResourceExW 函式 (libloaderapi.h)

決定在指定模組中具有指定類型、名稱及語言的資源位置。

語法

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 = lpTypelpNameIS_INTRESOURCETRUE,則 x 會指定指定資源類型或名稱的整數識別碼。 否則,這些參數是以 Null 結尾字串的長指標。 如果字串的第一個字元是井號 (#) ,則其餘字元代表十進位數,指定資源名稱或類型的整數識別碼。 例如,字串「#258」代表整數識別碼 258。

若要減少資源所需的記憶體量,應用程式應該以整數識別碼來參考它,而不是依名稱來參考它。

應用程式可以使用 FindResourceEx 來尋找任何類型的資源,但只有在應用程式必須存取二進位資源數據時,才應該使用這個函式,方法是後續呼叫 LoadResource ,然後呼叫 LockResource

若要立即使用資源,應用程式應該使用下列其中一個資源特定函式來尋找資源,並將資料轉換成更可用的形式。

功能 行動
格式訊息 載入並格式化訊息表格項目。
負載加速器 載入加速器表格。
載入點陣圖 載入點陣圖資源。
載入游標 載入游標資源。
載入圖示 載入圖示資源。
載入功能表 載入功能表資源。
載入字串 載入字串資料表項目。

例如,應用程式可以使用 LoadIcon 函式來載入圖示以在螢幕上顯示。 不過,如果應用程式正在載入圖示,將其數據複製到另一個應用程式,則應該使用 FindResourceExLoadResource

字串資源儲存在每個區段最多 16 個字串的區段中。 每個區段中的字串會儲存為計數 (不一定以 Null 結尾) Unicode 字串的序列。 LoadString 函式會從其對應的區段擷取字串資源。

需求

Requirement 價值觀
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平臺 窗戶
Header libloaderapi.h (包括 Windows.h)
Library 內核32。圖書館
DLL Kernel32.dll

另請參閱

尋找資源
格式訊息
IS_INTRESOURCE
負載加速器
載入點陣圖
載入游標
載入圖示
載入功能表
載入資源
載入字串
馬克蘭吉德

其他資源

參考
資源