Função LoadLibraryShim

  • Artigo

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

Esta função foi preterida no .NET Framework 4. Em alternativa, utilize 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 sem terminação que representa o nome da DLL a carregar a partir da biblioteca de .NET Framework.

szVersion
[in] Uma cadeia sem terminação que representa a versão da DLL a carregar. Se szVersion for nulo, a versão selecionada para carregamento é a versão mais recente da DLL especificada que é inferior à versão 4. Ou seja, todas as versões iguais ou superiores à versão 4 são ignoradas se szVersion forem nulas e, se não for instalada nenhuma versão inferior à versão 4, a DLL não será carregada. Isto serve para garantir que a instalação do .NET Framework 4 não afeta as aplicações ou componentes pré-existentes. Veja a entrada In-Proc SxS and Migration Quick Start (Início Rápido de Migração e SxS in-Proc ) no blogue da equipa do CLR.

pvReserved
Reservado para utilização futura.

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

Devolver Valor

Este método devolve códigos de erro COM (Component Object Model) padrão, conforme definido em WinError.h, além dos seguintes valores.

Código de retorno Descrição
S_OK O método foi concluído com êxito.
CLR_E_SHIM_RUNTIMELOAD szDllName O carregamento requer o carregamento do runtime de linguagem comum (CLR) e não é possível carregar a versão necessária do CLR.

Observações

Esta função é utilizada para carregar DLLs incluídos no pacote redistribuível .NET Framework. Não carrega DLLs gerados pelo utilizador.

Nota

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

Requisitos

Plataformas: Veja Requisitos de Sistema.

Cabeçalho: MSCorEE.h

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

Ver também