Compartilhar via

Função de LoadLibraryShim

  • Artigo

Carrega uma versão especificada de uma DLL que está incluída na.NET Framework completo.

Essa função foi preterida na .NET Framework versão 4. Use o ICLRRuntimeInfo::LoadLibrary método em vez disso.

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

Parâmetros

  • szDllName
    [in] Uma seqüência terminada em zero que representa o nome da DLL para ser carregado a partir do.Biblioteca do NET Framework.

  • szVersion
    [in] Uma seqüência terminada em zero que representa a versão da DLL a ser carregado. Se szVersion é nulo, a versão selecionada para o carregamento é a versão mais recente da DLL especificada que seja menor que a versão 4. Ou seja, todas as versões iguais ou maiores que a versão 4 são ignoradas se szVersion for nulo, e se nenhuma versão menor do que a versão 4 estiver instalado, a DLL Falha ao carregar. Isso é para garantir a instalação da .NET Framework 4 não afeta pré-existentes aplicativos ou componentes. Consulte a entrada em Proc SxS e migração Quick Start no blog da equipe do CLR.

  • pvReserved
    Reservado para uso futuro.

  • phModDll
    [out] Um ponteiro para a alça do módulo.

Valor de retorno

Esse método retorna os códigos de erro padrão do modelo de objeto componente (COM), conforme definido no Winerror. H, além de para os seguintes valores.

Código de retorno

Descrição

S_OK

O método foi concluído com êxito.

CLR_E_SHIM_RUNTIMELOAD

Carregando szDllName requer o carregamento, o common language runtime (CLR) e a versão necessária do CLR não podem ser carregado.

Comentários

Essa função é usada para carregar DLLs estão incluídas na.NET Framework completo. Ele não carregue DLLs gerados pelo usuário.

Observação

Começando com o.NET Framework versão 2.0, carregar Fusion. dll faz com que o CLR a ser carregado.Isso ocorre porque as funções no Fusion. dll agora são invólucros cujas implementações são fornecidas pelo runtime.

Requisitos

Plataformas: Consulte Requisitos de sistema do .NET Framework.

Cabeçalho: MSCorEE.h

.NET Framework versões: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0, 1.1, 1.0

Consulte também

Outros recursos

.NET Framework 1.1 e 2.0, hospedagem Global de funções estáticas

Histórico de alterações

Date

History

Motivo

Agosto de 2010

Descrito .NET Framework 4 em processo comportamento do lado a lado. Adicionado a lista de valores de retorno. Adicionado alternativa para o método substituído.

Correção de bug de conteúdo.