Funzione LoadLibraryShim

  • Articolo

Carica una versione specificata di una DLL inclusa nel pacchetto ridistribuibile di .NET Framework.

Questa funzione è stata deprecata in .NET Framework 4. Usare invece il metodo ICLRRuntimeInfo::LoadLibrary .

Sintassi

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 è la versione più recente della DLL specificata minore della versione 4. Vale a dire, tutte le versioni uguali o superiori alla versione 4 vengono ignorate se szVersion è Null e, se non è installata alcuna versione minore della versione 4, la DLL non riesce a caricare. Si tratta di garantire che l'installazione di .NET Framework 4 non influisca sulle applicazioni o i componenti preesistenti. Vedere la voce In-Proc SxS e Avvio rapido sulla migrazione nel blog del team CLR.

pvReserved
Riservato per utilizzi futuri.

phModDll
[out] Puntatore all'handle del modulo.

Valore restituito

Questo metodo restituisce i codici di errore COM (Component Object Model) standard, come definito in WinError.h, oltre ai valori seguenti.

Codice restituito Descrizione
S_OK Metodo completato correttamente.
CLR_E_SHIM_RUNTIMELOAD Il caricamento richiede il caricamento szDllName di Common Language Runtime (CLR) e la versione necessaria di CLR non può essere caricata.

Commenti

Questa funzione viene usata per caricare le DLL incluse nel pacchetto ridistribuibile di .NET Framework. Non carica le DLL generate dall'utente.

Nota

A partire da .NET Framework versione 2.0, il caricamento Fusion.dll causa il caricamento di 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: Disponibile da 1.0

Vedi anche