Função LoadLibraryShim

  • Artigo

Carrega uma versão especificada de uma DLL incluída no pacote redistribuível .NET Framework.

Essa função foi preterida no .NET Framework 4. Use o método ICLRRuntimeInfo::LoadLibrary.

Sintaxe

HRESULT LoadLibraryShim (  
    [in]  LPCWSTR  szDllName,  
    [in]  LPCWSTR  szVersion,  
          LPVOID   pvReserved,  
    [out] HMODULE *phModDll  
);

Parâmetros

szDllName
[in] Uma cadeia de caracteres que termina em zero que representa o nome da DLL a ser carregada da biblioteca de .NET Framework.

szVersion
[in] Uma cadeia de caracteres que termina em zero que representa a versão da DLL a ser carregada. Se szVersion for nulo, a versão selecionada para carregamento será a versão mais recente da DLL especificada que é menor que a versão 4. Ou seja, todas as versões iguais ou maiores que a versão 4 serão ignoradas se szVersion for nulo, e se nenhuma versão menor que a versão 4 estiver instalada, a DLL não será carregada. Isso é para garantir que a instalação do .NET Framework 4 não afete aplicativos ou componentes preexistentes. Consulte a entrada In-Proc SxS and Migration Quick Start no blog da equipe do CLR.

pvReserved
Reservado para uso futuro.

phModDll
[out] Um ponteiro para o identificador do módulo.

Valor Retornado

Esse método retorna códigos de erro COM (Component Object Model) padrão, conforme definido em WinError.h, além dos valores a seguir.

Código de retorno Descrição
S_OK O método foi concluído com sucesso.
CLR_E_SHIM_RUNTIMELOAD O carregamento de szDllName requer o carregamento do CLR (Common Language Runtime), e a versão necessária do CLR não pode ser carregada.

Comentários

Essa função é usada para carregar DLLs incluídas no pacote redistribuível .NET Framework. Ela não carrega DLLs geradas pelo usuário.

Observação

A partir do .NET Framework versão 2.0, carregar Fusion.dll faz com que o CLR seja carregado. Isso ocorre porque as funções em Fusion.dll agora são wrappers cujas implementações são fornecidas pelo runtime.

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: MSCorEE.h

Versões do .NET Framework: Disponível desde 1.0

Confira também