Função LoadMUILibraryW (muiload.h)

  • Artigo

Retorna um identificador para os recursos específicos do idioma associados a um arquivo LN (neutro em idioma) específico.

Nota Para garantir que a DLL seja descarregada corretamente, seus aplicativos devem corresponder cada chamada a LoadMUILibrary com uma chamada correspondente para FreeMUILibrary.
 

Sintaxe

HINSTANCE LoadMUILibraryW(
  [in] PCWSTR 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
MUI_LANGUAGE_ID
 Interprete o nome da pasta que contém os arquivos de recurso específicos do idioma usando o formato de identificador de idioma .
MUI_LANGUAGE_NAME
 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.

Valor Significado
MUI_LANGUAGE_EXACT
 Se os recursos para o idioma identificado não forem encontrados nos arquivos de recurso, marcar o módulo main especificado por pwszModuleName e retornará um identificador para esse módulo se tiver êxito.

[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:

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
Ao executar no Windows Vista, essa função carrega o módulo main sem redirecionamento. Somente o parâmetro pszFullModuleName é usado, pois as funções do carregador de recursos executam o redirecionamento adequadamente quando são chamadas. Ao ser executada em sistemas operacionais pré-Windows Vista, essa função leva em conta todos os parâmetros fornecidos pelo aplicativo. Ele redireciona o carregamento binário para o par binário satélite adequado associado ao arquivo representado por pszFullModuleName. Esse processo reconstitui o caminho associado ao arquivo para imitar o comportamento do Windows Vista que está por trás das funções do carregador de recursos.

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.

Confira também

FreeMUILibrary

Interface do Usuário Multilíngue

Funções de interface do usuário multilíngue