Função LoadMUILibraryA (muiload.h)

Artigo
11/20/2024

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

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

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

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, verifique o módulo principal especificado por pwszModuleName e retorne um identificador para esse módulo se tiver êxito.

[in] LangID

Identificador de linguagem 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:

Valor de retorno

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.

Observações

Essa função permite que os aplicativos desenvolvidos usando a tecnologia de recurso MUI Win32 determinem corretamente o arquivo de recurso específico do idioma 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 se 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 do idioma sejam armazenados usando convenções padrão. Consulte implantação de aplicativo para obter mais informações sobre o posicionamento do arquivo.

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 principal 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 executar 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 da linguagem para localizar um arquivo satélite.

O estado do identificador de idioma 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 para 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 de Gerenciamento de Linguagem da Interface do Usuário.

LoadMUILibrary é baseado 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.

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da 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.

Consulte também

FreeMUILibrary

de Interface do Usuário Multilíngue

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

Compartilhar via