共用方式為

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 失敗，此函式會傳回 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函式 上，而且需要將其使用方式套用類似的考慮。 特別是，FreeMUILibrary 應該針對 loadMUILibrary 所傳回的任何句柄呼叫。 此外，LoadMUILibrary 不應該從 DllMain呼叫。 如需詳細資訊，請參閱 LoadLibraryEx 和 FreeLibrary的一節。

注意

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

要求

要求 價值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平臺 窗戶
標頭 muiload.h
連結庫 Muiload.lib
可轉散發 Muiload.lib 包含在 Windows SDK for Windows 7 中，可在 Windows 2000 Professional、Windows 2000 Server、Windows XP、Windows Server 2003、Windows Vista、Windows Server 2008 和 Windows 7 上執行。

另請參閱

FreeMUILibrary

多語系使用者介面

多語系使用者介面函式