LoadLibraryShim (Función)
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