IHostAssemblyStore::ProvideAssembly (Método)

Artículo
10/07/2008

Actualización: noviembre 2007

Obtiene una referencia a un ensamblado al que no hace referencia la ICLRAssemblyReferenceList devuelta por IHostAssemblyManager::GetNonHostStoreAssemblies. Common Language Runtime (CLR) llama a ProvideAssembly para cada ensamblado que no aparece en la lista.

HRESULT ProvideAssembly (
    [in]  AssemblyBindInfo *pBindInfo,
    [out] UINT64           *pAssemblyId,
    [out] UINT64           *pHostContext,
    [out] IStream          **ppStmAssemblyImage,
    [out] IStream          **ppStmPDB
);

Parámetros

pBindInfo
[in] Puntero a una instancia de AssemblyBindInfo utilizada por el host para determinar ciertas características de enlace, incluida la presencia o ausencia de directivas de control de versiones, así como el ensamblado al que se va a realizar el enlace.
pAssemblyId
[out] Puntero a un identificador único para el ensamblado solicitado para esta instancia de IStream.
pHostContext
[out] Puntero a datos específicos del host que se utilizan para determinar la evidencia del ensamblado solicitado sin necesidad de una llamada de invocación de plataforma. pHostContext corresponde a la propiedad HostContext de la clase Assembly administrada.
ppStmAssemblyImage
[out] Puntero a la dirección de una instancia de IStream que contiene la imagen portable ejecutable (PE) que se va a cargar, o null si no se pudo encontrar el ensamblado.
ppStmPDB
[out] Puntero a la dirección de una instancia de IStream que contiene la información de depuración del programa (PDB), o null si no se pudo encontrar el archivo .pdb.

Valor devuelto

HRESULT	Descripción
S_OK	ProvideAssembly se devolvió correctamente.
HOST_E_CLRNOTAVAILABLE	CLR no se ha cargado en un proceso o está en un estado en el que no puede ejecutar el código administrado o procesar la llamada correctamente.
HOST_E_TIMEOUT	Se agotó el tiempo de espera de la llamada.
HOST_E_NOT_OWNER	El llamador no posee el bloqueo.
HOST_E_ABANDONED	Se canceló un evento mientras una fibra o un subproceso bloqueado estaba esperándole.
E_FAIL	Se ha producido un error irrecuperable desconocido. Cuando un método devuelve E_FAIL, CLR no se puede seguir utilizando en el proceso. Las llamadas subsiguientes a métodos de hospedaje devuelven HOST_E_CLRNOTAVAILABLE.
ERROR_FILE_NOT_FOUND	No se pudo localizar el ensamblado solicitado.
ERROR_INSUFFICIENT_BUFFER	El tamaño de búfer especificado por pAssemblyId no es lo suficientemente grande como para almacenar el identificador que desea devolver el host.

Comentarios

El host especifica el valor de identidad devuelto para pAssemblyId. Los identificadores deben ser únicos dentro del período de duración de un proceso. CLR utiliza este valor como identificador único de la secuencia. Compara cada valor con los valores para pAssemblyId devueltos por otras llamadas a ProvideAssembly. Si el host devuelve el mismo valor de pAssemblyId para otra instancia de IStream, CLR comprueba si el contenido de esa secuencia ya se ha asignado. En ese caso, el motor en tiempo de ejecución carga la copia existente de la imagen en lugar de asignar una nueva.