Funzione LoadMUILibraryW (muiload.h)

Articolo
11/20/2024

Restituisce un handle per le risorse specifiche della lingua associate a un particolare file LN (Language Neutral).

Nota Per assicurarsi che la DLL venga scaricata correttamente, le applicazioni devono corrispondere a ogni chiamata a LoadMUILibrary con una chiamata corrispondente a FreeMUILibrary.

Sintassi

HINSTANCE LoadMUILibraryW(
  [in] PCWSTR pszFullModuleName,
  [in] DWORD  dwLangConvention,
  [in] LANGID LangID
);

Parametri

[in] pszFullModuleName

Puntatore a una stringa con terminazione Null che specifica il nome di un file LN.

[in] dwLangConvention

Flag che specificano la convenzione di denominazione nei sistemi operativi Pre-Windows Vista per denominare le directory contenenti i file di risorse specifici della lingua. I flag si escludono a vicenda e il valore predefinito è MUI_LANGUAGE_NAME.

Valore	Significato
MUI_LANGUAGE_ID	Interpretare il nome della cartella contenente i file di risorse specifici della lingua usando formato di identificatore di lingua.
MUI_LANGUAGE_NAME	Interpretare il nome della cartella contenente i file di risorse specifici della lingua usando nome lingua formato.

Il flag seguente è disponibile come opzione e può essere usato in combinazione con uno degli altri flag.

Valore	Significato
MUI_LANGUAGE_EXACT	Se le risorse per la lingua identificata non vengono trovate nei file di risorse, controllare il modulo principale specificato da pwszModuleName e restituire un handle a tale modulo in caso di esito positivo.

[in] LangID

Identificatore di lingua per le risorse dell'interfaccia utente in un sistema operativo pre-Windows Vista. L'identificatore di lingua non può corrispondere alla lingua associata a una delle costanti di informazioni sulle impostazioni locali seguenti:

Valore restituito

Restituisce un handle al file di risorse specifico della lingua appropriato, se ha esito positivo.

Questa funzione restituisce NULL in caso di errore. Per ottenere informazioni estese sull'errore, l'applicazione può chiamare GetLastError.

Osservazioni

Questa funzione consente alle applicazioni sviluppate usando la tecnologia di risorse MUI Win32 di determinare correttamente il file di risorse specifico della lingua da caricare nei sistemi operativi Pre-Windows Vista. Le applicazioni che usano questa funzione non devono essere compilate specificamente in Windows Vista, ma devono collegarsi in modo statico alla libreria MUILoad fornita in Microsoft Windows SDK per Windows Vista. Questa funzione richiede che i file di risorse eseguibili e specifici del linguaggio vengano archiviati usando convenzioni standard. Per altre informazioni sul posizionamento dei file, vedere distribuzione di applicazioni .

Gli elementi seguenti influenzano il caricamento dei file binari satellite da questa funzione.

Versione del sistema operativo che esegue l'applicazione che chiama la funzione
Flag passato nel parametro dwLangConvention
Stato dell'identificatore di lingua passato nel parametro LangID

Durante l'esecuzione in Windows Vista, questa funzione carica il modulo principale senza reindirizzamento. Viene usato solo il parametro pszFullModuleName, perché le funzioni del caricatore di risorse eseguono il reindirizzamento in modo appropriato quando vengono chiamate. Quando si esegue nei sistemi operativi Windows Vista precedenti, questa funzione tiene conto di tutti i parametri forniti dall'applicazione. Reindirizza il caricamento binario alla coppia binaria satellite appropriata associata al file rappresentato da pszFullModuleName. Questo processo ricostituisce il percorso associato al file per simulare il comportamento di Windows Vista che sottostante le funzioni del caricatore di risorse.

L'applicazione usa il parametro dwLangConvention per specificare la modalità di probe dei file binari satellite. Se l'applicazione imposta questo parametro su MUI_LANGUAGE_ID, i file binari vengono distribuiti in cartelle con valori stringa esadecimali. Questi valori non includono la 0x iniziale e hanno una lunghezza di 4 caratteri. Ad esempio, en-US è rappresentato

come "0409" e en come "0009".) Se l'applicazione imposta il parametro su MUI_LANGUAGE_NAME, la funzione usa il caricamento delle risorse di Windows Vista, che usa probe di cartelle basate sul nome della lingua per trovare un file satellite.

Lo stato dell'identificatore di lingua nel parametro LangID influisce sul probe delle risorse. Se l'applicazione imposta questo parametro su 0, la funzione usa la logica di fallback predefinita, dipendente dal sistema operativo, per individuare il file di risorse specifico della lingua appropriato. Quando l'applicazione imposta LangID su un valore diverso da zero, il meccanismo di probe cerca solo la cartella denominata in modo appropriato e l'equivalente neutro associato. Per altre informazioni, vedere Gestione del linguaggio dell'interfaccia utente.

LoadMUILibrary è basato sulla funzione LoadLibraryExe considerazioni simili devono essere applicate al relativo utilizzo. In particolare, FreeMUILibrary deve essere chiamato per qualsiasi handle restituito da LoadMUILibrary. Inoltre, LoadMUILibrary non deve essere chiamato da DllMain. Per altre informazioni, vedere le sezioni Osservazioni di LoadLibraryEx e FreeLibrary.

Nota

L'intestazione muiload.h definisce LoadMUILibrary come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	muiload.h
libreria	Muiload.lib
Ridistribuibile	Muiload.lib, incluso in Windows SDK per Windows 7, che può essere eseguito in Windows 2000 Professional, Windows 2000 Server, Windows XP, Windows Server 2003, Windows Vista, Windows Server 2008 e Windows 7.

Vedere anche

FreeMUILibrary

dell'interfaccia utente multilingue

funzioni dell'interfaccia utente multilingue

Condividi tramite