Metodo ICLRDebuggingLibraryProvider2::ProvideLibrary2

Articolo
03/01/2024

Consente al debugger di fornire un percorso a una libreria di debug CLR (Common Language Runtime) specifica della versione.

Sintassi

HRESULT ProvideLibrary2 (
     [in] const WCHAR* pwszFileName,
     [in] DWORD dwTimestamp,
     [in] DWORD dwSizeOfImage,
     [out] LPWSTR* ppResolvedModulePath);

Parametri

pwszFilename
[in] Nome del modulo richiesto.

dwTimestamp
[in] Timestamp di data archiviato nell'intestazione del file COFF dei file PE.

dwSizeOfImage
[in] Campo SizeOfImage archiviato nell'intestazione facoltativa del file COFF dei file PE.

ppResolvedModulePath
[out] Si tratta di un percorso con terminazione Null per dll del modulo. In Windows deve essere allocato con CoTaskMemAlloc. In Unix deve essere allocato con malloc. L'errore lascia tutto invariato. Vedere di seguito la nota sulla sicurezza.

Valore restituito

Questo metodo restituisce gli specifici HRESULT seguenti, nonché gli errori di HRESULT che indicano la mancata riuscita del metodo.

HRESULT	Descrizione
`S_OK`	Metodo completato correttamente.

Osservazioni:

ProvideLibrary2 consente al debugger di fornire moduli necessari per il debug di file CLR specifici, ad esempio mscordbi.dll e mscordacwks.dll.

Il debugger può usare qualsiasi mezzo disponibile per individuare o procurarsi il modulo di debug.

Importante

Questa funzionalità consente al chiamante API di fornire moduli che contengono file eseguibili ed eventualmente codice dannoso. Come precauzione di sicurezza, il chiamante non deve usare ProvideLibrary2 per distribuire codice che non disponibile per l’esecuzione.

Se viene rilevato un problema di sicurezza grave in una libreria già rilasciata, ad esempio mscordbi.dll o mscordacwks.dll, lo shim può essere sottoposto ad applicazione di patch per riconoscere le versioni non corrette dei file. Lo shim può quindi inviare richieste per le versioni con patch dei file e rifiutare le versioni non valide se vengono fornite in risposta a qualsiasi richiesta. Questo problema può verificarsi solo se l'utente ha eseguito applicazioni di patch a una nuova versione di shim. Le versioni senza patch rimarranno vulnerabili.

Requisiti

Piattaforme: vedere Sistemi operativi supportati da .NET.

Intestazione: dbgshim.h

Libreria: dbgshim.dll, libdbgshim.so, libdbgshim.dylib

Versioni .NET: disponibili a partire da .NET Core 2.1

Condividi tramite