Funzione LoadMUILibraryA (muiload.h)
Restituisce un handle alle risorse specifiche della lingua associate a un determinato file LN (Language Neutral).
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 |
---|---|
|
Interpretare il nome della cartella contenente i file di risorse specifici della lingua usando il formato dell'identificatore della lingua . |
|
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.
[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:
- LOCALE_SYSTEM_DEFAULT
- LOCALE_USER_DEFAULT
- LOCALE_CUSTOM_DEFAULT
- LOCALE_CUSTOM_UI_DEFAULT
- LOCALE_CUSTOM_UNSPECIFIED
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
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. |