Função LoadLibraryShim
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
