_CorValidateImage (Función)
Valida las imágenes del módulo administrado y notifica al cargador del sistema operativo después de cargarse.
Sintaxis
STDAPI _CorValidateImage (
[in] PVOID* ImageBase,
[in] LPCWSTR FileName
);
Parámetros
ImageBase
[in] Puntero a la ubicación inicial de la imagen que se va a validar como código administrado. La imagen ya debe estar cargada en la memoria.
FileName
[in] Nombre de archivo de la imagen.
Valor devuelto
Esta función devuelve los valores E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED y E_FAIL estándar, así como los valores siguientes.
| Valor devuelto | Descripción |
|---|---|
STATUS_INVALID_IMAGE_FORMAT |
La imagen no es válida. Este valor tiene el HRESULT 0xC000007BL. |
STATUS_SUCCESS |
La imagen es válida. Este valor tiene el HRESULT 0x00000000L. |
Comentarios
En Windows XP y versiones posteriores, el cargador del sistema operativo comprueba si hay módulos administrados examinando el bit del directorio de descriptores COM en el encabezado del formato de archivo de objeto común (COFF). Un bit establecido indica un módulo administrado. Si el cargador detecta un módulo administrado, carga MsCorEE.dll y llama a _CorValidateImage, que realiza las acciones siguientes:
Confirma que la imagen es un módulo administrado válido.
Cambia el punto de entrada en la imagen a un punto de entrada en Common Language Runtime (CLR).
En las versiones de 64 bits de Windows, modifica la imagen que está en la memoria transformando el formato PE32 en PE32+.
Vuelve al cargador cuando se cargan las imágenes del módulo administrado.
En el caso de las imágenes ejecutables, el cargador del sistema operativo llama a la función _CorExeMain, independientemente del punto de entrada especificado en el ejecutable. En el caso de las imágenes de ensamblado DLL, el cargador llama a la función _CorDllMain.
_CorExeMain o _CorDllMain realiza las acciones siguientes:
Inicializa CLR.
Busca el punto de entrada administrado desde el encabezado CLR del ensamblado.
Comienza la ejecución.
El cargador llama a la función _CorImageUnloading cuando se descargan imágenes del módulo administradas. Pero esta función no realiza ninguna acción; simplemente devuelve un valor.
Requisitos
Plataformas: Vea Requisitos de sistema.
Encabezado: Cor.h
Biblioteca: incluida como recurso en MsCorEE.dll
Versiones de .NET Framework: está disponible desde la versión 1.0
