LoadLibraryShim (Función)

Carga una versión especificada de una DLL que está incluida en el paquete redistribuible .NET Framework.

Esta función está desusada en .NET Framework versión 4. En su lugar, use el método ICLRRuntimeInfo::LoadLibrary.

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

Parámetros

• szDllName
  [in] Cadena terminada en cero que representa el nombre de la DLL que se va a cargar de la biblioteca de .NET Framework.

• szVersion
  [in] Cadena terminada en cero que representa la versión de la DLL que se va a cargar. Si szVersion es null, la versión seleccionada para cargar es la última versión del archivo DLL especificado que sea inferior a la versión 4. Es decir, todas las versiones iguales o posteriores a la versión 4 se omiten si szVersion es null y, si no hay instalada ninguna versión anterior a la 4, la DLL no se carga. Esto garantiza que la instalación de .NET Framework 4 no afecta a las aplicaciones o componentes ya existentes. Consulte la información sobre In-Proc SxS and Migration Quick Start en el blog del equipo de CLR.

• pvReserved
  Reservado para un uso futuro.

• phModDll
  [out] Puntero al identificador del módulo.

Valor devuelto

Este método devuelve los códigos de error estándar del Modelo de objetos componentes (COM), tal como se encuentran definidos en WinError.h, además de los valores siguientes.

Código devuelto	Descripción
S_OK	El método se ha ejecutado correctamente.
CLR_E_SHIM_RUNTIMELOAD	Para cargar szDllName es necesario cargar Common Language Runtime (CLR), pero no se puede cargar la versión necesaria de CLR.

Comentarios

Esta función se utiliza para cargar las DLL que están incluidas en el paquete redistribuible de .NET Framework. No carga las DLL generadas por usuario.

Nota
A partir de la versión 2.0 de .NET Framework, al cargar Fusion.dll se carga CLR.Esto se debe a que las funciones de Fusion.dll son ahora contenedores cuyas implementaciones las proporciona el runtime.

Requisitos

Plataformas: vea Requisitos de sistema de .NET Framework.

Encabezado: MSCorEE.h

Versiones de .NET Framework: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0, 1.1, 1.0

Vea también

Otros recursos

Funciones estáticas globales de hospedaje de .NET Framework 1.1 y 2.0

Historial de cambios

Fecha	Historial	Motivo
Agosto de 2010	Se describió el comportamiento en paralelo en proceso de .NET Framework 4. Se agregó una lista de valores devueltos. Se agregó una alternativa para el método desusado.	Corrección de errores de contenido.