Funzione LoadMUILibraryA (muiload.h)

Articolo
03/05/2024

Restituisce un handle alle risorse specifiche della lingua associate a un determinato 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 LoadMUILibraryA(
  [in] PCSTR  pszFullModuleName,
  [in] DWORD  dwLangConvention,
  [in] LANGID LangID
);

Parametri

[in] pszFullModuleName

Puntatore a una stringa con terminazione null specificando il nome di un file LN.

[in] dwLangConvention

Flag che specificano la convenzione di denominazione nei sistemi operativi pre-Windows Vista per assegnare un nome alle directory contenenti i file di risorse specifici della lingua. I flag sono reciprocamente esclusivi 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 il formato dell'identificatore della lingua .
MUI_LANGUAGE_NAME	Interpretare il nome della cartella contenente i file di risorse specifici della lingua usando il formato del nome della lingua .

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 se riuscito.

[in] LangID

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

Valore restituito

Restituisce un handle al file di risorse specifico del linguaggio appropriato, se riuscito.

Questa funzione restituisce NULL se ha esito negativo. Per ottenere informazioni sull'errore estese, l'applicazione può chiamare GetLastError.

Commenti

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

Gli elementi seguenti influiscono sul 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 della lingua passato nel parametro LangID

Quando si esegue in Windows Vista, questa funzione carica il modulo principale senza reindirizzamento. Viene usato solo il parametro pszFullModuleName , poiché le funzioni del caricatore di risorse eseguono il reindirizzamento in modo appropriato quando vengono chiamate. Quando si esegue nei sistemi operativi pre-Windows Vista, 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 sottolizza le funzioni del caricatore delle 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 impostati in cartelle con valori stringa esadecimali. Questi valori non includono l'0x iniziale e sono 4 caratteri in lunghezza. 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 della lingua nel parametro LangID influisce sul probing 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 del linguaggio appropriato. Quando l'applicazione imposta LangID su un valore diverso da zero, il meccanismo di analisi esegue solo ricerche nella cartella denominata appropriata e nel relativo equivalente neutrale associato. Per altre informazioni, vedere Gestione linguaggio interfaccia utente.

LoadMUILibrary è basato sulla funzione LoadLibraryEx e devono essere applicate considerazioni simili all'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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	muiload.h
Libreria	Muiload.lib
Componente ridistribuibile	Muiload.lib, incluso nel 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.

Vedi anche

FreeMUILibrary

Interfaccia utente multilingue

Funzioni dell'interfaccia utente multilingue

Share via