Compartir a través de

LoadLibraryShim (Función)

  • Artículo

Carga una versión especificada de un archivo DLL que se incluye en el paquete redistribuible de .NET Framework.

Esta función está en desuso en .NET Framework 4. Use el método ICLRRuntimeInfo::LoadLibrary en su lugar.

Sintaxis

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 del archivo DLL que se va a cargar desde la biblioteca de .NET Framework.

szVersion
[in] Cadena terminada en cero que representa la versión del archivo DLL que se va a cargar. Si szVersion es null, la versión seleccionada para cargar es la versión más reciente del archivo DLL especificado que es menor que la versión 4. Es decir, todas las versiones iguales o superiores a la versión 4 se omiten si szVersion es null y, si no hay ninguna versión inferior a la versión 4 instalada, el archivo DLL no se carga. Esto es para asegurarse de que la instalación de .NET Framework 4 no afecta a las aplicaciones o componentes preexistentes. Consulte la entrada Inicio rápido de SxS y migración en el blog del equipo de CLR.

pvReserved
Reservado para uso futuro.

phModDll
[out] El valor de este parámetro se corresponde con un puntero que apunta al manipulador del módulo.

Valor devuelto

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

Código devuelto Descripción
S_OK El método se completó correctamente.
CLR_E_SHIM_RUNTIMELOAD Para cargar szDllName necesita cargarse Common Language Runtime (CLR) y la versión necesaria de CLR no se puede cargar.

Comentarios

Esta función se usa para cargar archivos DLL que se incluyen en el paquete redistribuible de .NET Framework. No carga archivos DLL generados por el usuario.

Nota

A partir de .NET Framework versión 2.0, la carga Fusion.dll hace que CLR se cargue. Esto se debe a que las funciones de Fusion.dll ahora son contenedores cuyas implementaciones proporciona el tiempo de ejecución.

Requisitos

Plataformas: Vea Requisitos de sistema.

Encabezado: MSCorEE.h

Versiones de .NET Framework: disponible a partir de la versión 1.0

Consulte también