_CorValidateImage Function

Valida las imágenes del módulo administrado y notifica al cargador del sistema operativo una vez cargados.

Syntax

STDAPI _CorValidateImage (
   [in] PVOID* ImageBase,
   [in] LPCWSTR FileName
);

Parameters

ImageBase [in] Puntero a la ubicación inicial de la imagen que se va a validar como código administrado. La imagen ya debe cargarse en la memoria.

FileName [in] Nombre de archivo de la imagen.

Return Value

Esta función devuelve los valores E_INVALIDARGestándar , E_OUTOFMEMORY, E_UNEXPECTEDy E_FAIL, así como los valores siguientes.

Remarks

En Windows XP y versiones posteriores, el cargador del sistema operativo comprueba si hay módulos administrados examinando el bit directorio de descriptores COM en el encabezado de 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 siguientes acciones:

• Confirma que la imagen es un módulo administrado válido.

• Cambia el punto de entrada de la imagen a un punto de entrada en Common Language Runtime (CLR).

• Para las versiones de 64 bits de Windows, modifica la imagen que está en memoria transformándola de PE32 a formato 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 archivo ejecutable. En el caso de las imágenes de ensamblado DLL, el cargador llama a la función _CorDllMain .

_CorExeMain o _CorDllMain realiza las siguientes acciones:

• Inicializa CLR.

• Busca el punto de entrada administrado desde el encabezado CLR del ensamblado.

• Begins execution.

El cargador llama a la función _CorImageUnloading cuando se descargan imágenes de módulo administradas. Sin embargo, esta función no realiza ninguna acción; simplemente devuelve.

Requirements

Plataformas: Vea Requisitos de sistema.

Header: Cor.h

Biblioteca: Incluido como recurso en MsCorEE.dll

Versiones de .NET Framework: Disponible desde la versión 1.0