共用方式為

LoadMUILibraryA 函式 (muiload.h)

  • 發行項

傳回與特定語言中性 (LN) 檔案相關聯的語言特定資源的句柄。

注意為了確保 DLL 已正確卸除，您的應用程式應該比對 LoadMUILibrary 的每個呼叫與 FreeMUILibrary 的對應呼叫。
 

語法

HINSTANCE LoadMUILibraryA(
  [in] PCSTR  pszFullModuleName,
  [in] DWORD  dwLangConvention,
  [in] LANGID LangID
);

參數

[in] pszFullModuleName

指定 LN 檔名的 Null 終止字串指標。

[in] dwLangConvention

旗標，指定 Windows Vista 作業系統上的命名慣例，以命名包含語言特定資源文件的目錄。 旗標互斥，預設值為 MUI_LANGUAGE_NAME。

值 意義
MUI_LANGUAGE_ID
 使用 語言識別碼 格式解譯包含語言特定資源檔的資料夾名稱。
MUI_LANGUAGE_NAME
 使用 語言名稱 格式解譯包含語言特定資源檔的資料夾名稱。
 

下列旗標可做為選項使用，並可搭配其他旗標之一使用。

值 意義
MUI_LANGUAGE_EXACT
 如果在資源檔中找不到所識別語言的資源，請檢查 pwszModuleName 所指定的主要模組，並在成功時傳回該模組的句柄。

[in] LangID

Windows Vista 操作系統上使用者介面資源的語言標識碼。 語言標識碼無法對應到與下列任何地區設定資訊常數相關聯的語言：

傳回值

如果成功，則會傳回適當語言特定資源檔的句柄。

如果函式失敗，此函式會傳回 NULL 。 若要取得延伸的錯誤資訊，應用程式可以呼叫 GetLastError。

備註

此函式可讓使用 Win32 MUI 資源技術開發的應用程式，以正確判斷在 Windows Vista 前作業系統上載入的語言特定資源檔。 使用此函式的應用程式不需要特別建置在 Windows Vista 上，但必須以靜態方式與 Windows Vista Microsoft Windows SDK 中提供的 MUILoad 連結庫連結。 此函式需要使用標準慣例來儲存可執行檔和語言特定的資源檔。 如需檔案放置的詳細資訊，請參閱 應用程式部署 。

下列專案會影響此函式載入附屬二進位檔。

  • 執行呼叫函式之應用程式的作業系統版本
  • 傳入 dwLangConvention 參數的旗標
  • 在 LangID 參數中傳遞的語言標識碼狀態
在 Windows Vista 上執行時，此函式會載入主要模組，而不需重新導向。 只會使用 pszFullModuleName 參數，因為資源載入器函式會在呼叫時適當地執行重新導向。 在 Windows Vista 作業系統上執行時，此函式會將應用程式提供的所有參數納入考慮。 它會將二進位檔載入重新導向至與 pszFullModuleName 所代表之檔案相關聯的適當附屬二進位檔。 此程式會重新建構與檔案相關聯的路徑，以模擬資源載入器函式的 Windows Vista 行為。

應用程式會使用 dwLangConvention 參數來指定應探查附屬二進位檔的方式。 如果應用程式將此參數設定為MUI_LANGUAGE_ID，則會在具有十六進位字元串值的資料夾中探查二進位檔。 (這些值不包含前置 0x，且長度為 4 個字元。 例如，en-US 代表

as “0409” and en as “0009”.) 如果應用程式將 參數設定為 MUI_LANGUAGE_NAME，函式會使用 Windows Vista 資源載入，它會使用語言名稱型資料夾探查來尋找附屬檔案。

LangID 參數中語言標識碼的狀態會影響資源探查。 如果應用程式將此參數設定為 0，則函式會使用與作業系統相依的預先定義後援邏輯來找出適當的特定語言資源檔。 當應用程式將 LangID 設定為非零值時，探查機制只會搜尋適當命名的資料夾及其相關聯的中性對等專案。 如需詳細資訊，請參閱 使用者介面語言管理。

LoadMUILibrary 建置在 LoadLibraryEx 函式上，而且需要將類似的考慮套用至其使用方式。 特別是，應該針對 LoadMUILibrary 所傳回的任何句柄呼叫 FreeMUILibrary。 此外，不應該從 DllMain 呼叫 LoadMUILibrary。 如需詳細資訊，請參閱 LoadLibraryEx 和 FreeLibrary 的 小節。

注意

muiload.h 標頭會將 LoadMUILibrary 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 muiload.h
程式庫 Muiload.lib
可轉散發套件 Muiload.lib 包含在適用於 Windows 7 的 Windows SDK，可在 Windows 2000 專業版、Windows 2000 Server、Windows XP、Windows Server 2003、Windows Vista、Windows Server 2008 和 Windows 7 上執行。

另請參閱

FreeMUILibrary

多語系使用者介面

多語系使用者介面函式