Método IHostAssemblyStore::ProvideModule

Artigo
08/25/2010

Resolve um arquivo de recurso do módulo dentro de um assembly ou um vinculado (mas não um incorporado).

HRESULT ProvideModule (
    [in]  ModuleBindInfo *pBindInfo,
    [out] DWORD          *pdwModuleId,
    [out] IStream        **ppStmModuleImage,
    [out] IStream        **ppStmPDB
);

Parâmetros

pBindInfo
[in] Um ponteiro para um ModuleBindInfo instância que descreve AppDomain, assembly e o nome do módulo.
pdwModuleId
[out] Um ponteiro para um identificador exclusivo para o IStream que contém o módulo carregado.
ppStmModuleImage
[out] Um ponteiro para o endereço de um IStream objeto, que contém a imagem executável portátil (PE) a ser carregado ou nulo se o módulo não foi encontrado.
ppStmPDB
[out] Um ponteiro para o endereço de um IStream objeto, que contém as informações de depurar (PDB) de programa para o módulo solicitado ou nulo se o arquivo .pdb não pôde ser encontrado.

Valor de retorno

HRESULT	Descrição
S_OK	ProvideModule retornado com êxito.
HOST_E_CLRNOTAVAILABLE	O common linguagem tempo de execução (CLR) não foi carregado em um processo ou o CLR está em um estado em que ele não possa executar código gerenciado ou processar a telefonar com êxito.
HOST_E_TIMEOUT	A telefonar expirou.
HOST_E_NOT_OWNER	O chamador não é proprietário do bloquear.
HOST_E_ABANDONED	Um evento foi cancelado enquanto um segmento bloqueado ou fibra estava aguardando nele.
E_FAIL	Ocorreu uma falha catastrófica desconhecida. Quando um método retorna E_FAIL, o CLR não é mais útil dentro do processo. As chamadas subseqüentes à hospedagem métodos retornam HOST_E_CLRNOTAVAILABLE.
ERROR_FILE_NOT_FOUND	O assembly solicitado ou recurso vinculado não pôde ser localizado.
ERROR_INSUFFICIENT_BUFFER	pdwModuleId não é grande o suficiente para conter o identificador de que o host deseja retornar.

Comentários

O valor de identidade retornado para pdwModuleId é especificado pelo host. Os identificadores devem ser exclusivos dentro do tempo de vida de um processo. O CLR usa esse valor sistema autônomo o identificador exclusivo para o fluxo associado. Ele verifica cada valor em relação aos valores de pAssemblyId retornado por chamadas para ProvideAssembly e os valores de pdwModuleId retornado por outras chamadas para ProvideModule. Se o host retorna o mesmo valor identificador para o outro IStream, o CLR verifica se o Sumário de fluxo que já foram mapeado. Nesse caso, o CLR carrega a cópia existente da imagem em vez de um novo mapeamento. Portanto, o identificador deve também não se sobrepor a identificadores de assembly retornados de ProvideAssembly.