Função LoadMUILibraryA (muiload.h)
Retorna um identificador para os recursos específicos do idioma associados a um arquivo LN (neutro em idioma) específico.
Sintaxe
HINSTANCE LoadMUILibraryA(
[in] PCSTR pszFullModuleName,
[in] DWORD dwLangConvention,
[in] LANGID LangID
);
Parâmetros
[in] pszFullModuleName
Ponteiro para uma cadeia de caracteres terminada em nulo especificando o nome de um arquivo LN.
[in] dwLangConvention
Sinalizadores que especificam a convenção de nomenclatura em sistemas operacionais pré-Windows Vista para nomear os diretórios que contêm os arquivos de recurso específicos do idioma. Os sinalizadores são mutuamente exclusivos e o padrão é MUI_LANGUAGE_NAME.
| Valor | Significado |
|---|---|
|
Interprete o nome da pasta que contém os arquivos de recurso específicos do idioma usando o formato de identificador de idioma . |
|
Interprete o nome da pasta que contém os arquivos de recurso específicos do idioma usando o formato de nome de idioma . |
O sinalizador a seguir está disponível como uma opção e pode ser usado em combinação com qualquer um dos outros sinalizadores.
[in] LangID
Identificador de idioma para os recursos de interface do usuário em um sistema operacional pré-Windows Vista. O identificador de idioma não pode corresponder ao idioma associado a nenhuma destas constantes de informações de localidade:
- LOCALE_SYSTEM_DEFAULT
- LOCALE_USER_DEFAULT
- LOCALE_CUSTOM_DEFAULT
- LOCALE_CUSTOM_UI_DEFAULT
- LOCALE_CUSTOM_UNSPECIFIED
Retornar valor
Retorna um identificador para o arquivo de recurso específico do idioma apropriado, se bem-sucedido.
Essa função retornará NULL se falhar. Para obter informações de erro estendidas, o aplicativo pode chamar GetLastError.
Comentários
Essa função permite que aplicativos desenvolvidos usando a tecnologia de recursos MUI win32 determinem corretamente o arquivo de recurso específico da linguagem a ser carregado em sistemas operacionais pré-Windows Vista. Os aplicativos que usam essa função não precisam ser criados especificamente no Windows Vista, mas precisam vincular estaticamente à biblioteca MUILoad fornecida no SDK do Microsoft Windows para Windows Vista. Essa função requer que os arquivos de recurso executáveis e específicos de linguagem sejam armazenados usando convenções padrão. Consulte Implantação de aplicativo para obter mais informações sobre o posicionamento de arquivos.
Os itens a seguir influenciam o carregamento de binários satélites por essa função.
- Versão do sistema operacional executando o aplicativo que chama a função
- Sinalizador passado no parâmetro dwLangConvention
- Estado do identificador de idioma passado no parâmetro LangID
O aplicativo usa o parâmetro dwLangConvention para especificar a maneira como os binários satélites devem ser investigados. Se o aplicativo definir esse parâmetro como MUI_LANGUAGE_ID, os binários serão investigados em pastas com valores de cadeia de caracteres hexadecimal. (Esses valores não incluem o 0x à esquerda e têm 4 caracteres de comprimento. Por exemplo, en-US é representado
como "0409" e en como "0009".) Se o aplicativo definir o parâmetro como MUI_LANGUAGE_NAME, a função usará o carregamento de recursos do Windows Vista, que usa investigações de pasta baseadas em nome de idioma para localizar um arquivo satélite.
O estado do identificador de linguagem no parâmetro LangID afeta a investigação de recursos. Se o aplicativo definir esse parâmetro como 0, a função usará a lógica de fallback predefinida, dependente do sistema operacional, para localizar o arquivo de recurso específico do idioma apropriado. Quando o aplicativo define LangID como um valor diferente de zero, o mecanismo de investigação pesquisa apenas a pasta apropriadamente nomeada e seu equivalente neutro associado. Para obter mais informações, consulte Gerenciamento de linguagem de interface do usuário.
LoadMUILibrary baseia-se na função LoadLibraryEx e considerações semelhantes precisam ser aplicadas ao seu uso. Em particular, FreeMUILibrary deve ser chamado para qualquer identificador retornado por LoadMUILibrary. Além disso, LoadMUILibrary não deve ser chamado de DllMain. Para obter mais informações, consulte as seções Comentários de LoadLibraryEx e FreeLibrary.
Observação
O cabeçalho muiload.h define LoadMUILibrary como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | muiload.h |
| Biblioteca | Muiload.lib |
| Redistribuível | Muiload.lib, incluído no SDK do Windows para Windows 7 que pode ser executado no Windows 2000 Professional, Windows 2000 Server, Windows XP, Windows Server 2003, Windows Vista, Windows Server 2008 e Windows 7. |