Método de ICLRDebuggingLibraryProvider::ProvideLibrary

Artigo
08/08/2011

Obtém um provedor de biblioteca de interface de retorno de chamada que permite que o common language runtime (CLR) específicas da versão depuração bibliotecas demanda localizada e carregada no.

    HRESULT ProvideLibrary(
         [in] const WCHAR* pwszFileName,
         [in] DWORD dwTimestamp,
         [in] DWORD dwSizeOfImage,
         [out] HMODULE* hModule);

Parâmetros

pwszFilename
[in] O nome do módulo que está sendo solicitado.
dwTimestamp
[in] A data e hora armazenada no cabeçalho do arquivo COFF dos arquivos PE.
pLibraryProvider
[in] O SizeOfImage campo armazenado no cabeçalho de arquivo opcional COFF de todos os arquivos PE.
hModule
[out] O identificador do módulo solicitado.

Valor de retorno

Esse método retorna o seguintes HRESULTs específicos, bem como o HRESULT erros que indicam falha de método.

HRESULT	Descrição
S_OK	O método foi concluído com êxito.

Comentários

ProvideLibrarypermite que o depurador forneça os módulos que são necessários para depuração de arquivos específicos do CLR, como o mscordbi. dll e o arquivo Mscordacwks. dll. As alças do módulo tem permaneça válida até uma chamada para o ICLRDebugging::CanUnloadNow método indica que pode ser liberados, o ponto em que é responsabilidade do chamador para liberar as alças.

O depurador pode usar qualquer meio disponível para localizar ou adquirir o módulo de depuração.

Importante
Esse recurso permite que o chamador da API fornecer os módulos que contêm código executável e possivelmente mal-intencionado.Como precaução de segurança, o chamador não deve usar ProvideLibrary para distribuir qualquer código que não está disposta a executar a mesmo. Se uma séria questão de segurança for descoberta em uma biblioteca já lançada, como, por exemplo, o mscordbi. dll ou o arquivo Mscordacwks. dll, a correção pode ser corrigida para reconhecer as ruins versões dos arquivos.A correção pode emitir solicitações para as versões dos arquivos de corrigida e rejeitar as versões ruins se eles são fornecidos em resposta a qualquer solicitação.Isso só pode ocorrer se o usuário tiver corrigido para uma nova versão da correção.Versões sem patch permanecerá vulneráveis.

Esse recurso permite que o chamador da API fornecer os módulos que contêm código executável e possivelmente mal-intencionado.Como precaução de segurança, o chamador não deve usar ProvideLibrary para distribuir qualquer código que não está disposta a executar a mesmo.

Se uma séria questão de segurança for descoberta em uma biblioteca já lançada, como, por exemplo, o mscordbi. dll ou o arquivo Mscordacwks. dll, a correção pode ser corrigida para reconhecer as ruins versões dos arquivos.A correção pode emitir solicitações para as versões dos arquivos de corrigida e rejeitar as versões ruins se eles são fornecidos em resposta a qualquer solicitação.Isso só pode ocorrer se o usuário tiver corrigido para uma nova versão da correção.Versões sem patch permanecerá vulneráveis.

Requisitos

Plataformas: Consulte Requisitos de sistema do .NET Framework.

Cabeçalho: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

.NET Framework versões: 4

Consulte também

Outros recursos

Interfaces de depuração.

Depuração (referência de API não gerenciada)

Compartilhar via