Funzione LoadLibraryShim

Carica una versione specificata di una DLL inclusa nel .NET Framework Redistributable Package.

Questa funzione è deprecata in .NET Framework versione 4. Utilizzare il metodo ICLRRuntimeInfo::LoadLibrary.

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

Parametri

• szDllName
  [in] Stringa con terminazione zero che rappresenta il nome della DLL da caricare dalla libreria .NET Framework.

• szVersion
  [in] Stringa con terminazione zero che rappresenta la versione della DLL da caricare. Se szVersion è null, la versione selezionata per il caricamento è l'ultima versione della DLL specificata inferiore alla versione 4. In altre parole, ogni versione uguale a o maggiore della versione 4 viene ignorata se szVersion è null e non è installata alcuna versione inferiore alla versione 4, la DLL non viene caricata. In questo modo si garantisce che l'installazione di .NET Framework 4 non influisca sulle applicazioni o sui componenti preesistenti. Vedere la voce Guida introduttiva di SxS e migrazione in-process nel blog del team di CLR.

• pvReserved
  Riservato per un utilizzo futuro.

• phModDll
  [out] Puntatore all'handle del modulo.

Valore restituito

Questo metodo restituisce i codici di errore COM (Component Object Model) standard definiti in WinError.h, oltre ai valori riportati di seguito.

Codice restituito	Oggetto di descrizione
S_OK	Il metodo è stato eseguito correttamente.
CLR_E_SHIM_RUNTIMELOAD	Per il caricamento di szDllName è necessario il caricamento del CLR (Common Language Runtime) e non è possibile caricare la versione richiesta di CLR.

Note

Questa funzione viene utilizzata per caricare le DLL incluse nel .NET Framework Redistributable Package. Non carica le DLL generate dall'utente.

Nota
A partire da .NET Framework versione 2.0, se si carica Fusion.dll viene di conseguenza caricato il CLR.Ciò è dovuto al fatto che le funzioni in Fusion.dll sono ora wrapper le cui implementazioni vengono fornite dal runtime.

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: MSCorEE.h

Versioni di .NET Framework: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0, 1.1, 1.0

Vedere anche

Altre risorse

Funzioni statiche globali di hosting di .NET Framework 1.1 e 2.0

Cronologia delle modifiche

Data	Cronologia	Motivo
Agosto 2010	Descritto .NET Framework 4 nel comportamento in-process e side-by-side. È stato aggiunto un elenco di valori restituiti. È stata aggiunta un'alternativa per il metodo obsoleto.	Correzione di bug nel contenuto.