Método ICLRDebuggingLibraryProvider::P rovideLibrary

Artigo
05/09/2023

Obtém uma interface de chamada de retorno do fornecedor de bibliotecas que permite que bibliotecas de depuração específicas de versões do runtime de linguagem comum (CLR) sejam localizadas e carregadas a pedido.

Sintaxe

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á a ser pedido.

dwTimestamp
[in] O carimbo de data/hora armazenado no cabeçalho do ficheiro COFF dos ficheiros PE.

dwSizeOfImage
[in] O SizeOfImage campo armazenado no cabeçalho de ficheiro opcional COFF de ficheiros PE.

hModule
[fora] A alça para o módulo pedido.

Devolver Valor

Este método devolve os seguintes HRESULTs específicos, bem como erros HRESULT que indicam a falha do método.

HRESULT	Description
S_OK	O método foi concluído com êxito.

Exceções

Observações

ProvideLibrary permite que o depurador forneça módulos necessários para depurar ficheiros CLR específicos, como mscordbi.dll e mscordacwks.dll. Os identificadores do módulo têm de permanecer válidos até que uma chamada para o método ICLRDebugging::CanUnloadNow indique que podem ser libertados, altura em que é da responsabilidade do autor da chamada libertar as alças.

O depurador pode utilizar quaisquer meios disponíveis para localizar ou obter o módulo de depuração.

Importante

Esta funcionalidade permite que o autor da chamada à API forneça módulos que contenham código executável e possivelmente malicioso. Como precaução de segurança, o autor da chamada não deve utilizar ProvideLibrary para distribuir qualquer código que não esteja disposto a executar sozinho.

Se for detetado um problema de segurança grave numa biblioteca já lançada, como mscordbi.dll ou mscordacwks.dll, o shim pode ser corrigido para reconhecer as versões incorretas dos ficheiros. Em seguida, o shim pode emitir pedidos para as versões corrigidas dos ficheiros e rejeitar as versões incorretas se forem fornecidas em resposta a qualquer pedido. Isto só pode ocorrer se o utilizador tiver corrigido para uma nova versão do shim. As versões sem correspondência continuarão vulneráveis.

Requisitos

Plataformas: Veja Requisitos do Sistema.

Cabeçalho: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

.NET Framework Versões: Disponível desde 4

Partilhar via