Metodo ICLRDebuggingLibraryProvider3::ProvideUnixLibrary

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

Sintassi

HRESULT ProvideUnixLibrary (
     [in] const WCHAR* pwszFileName,
     [in] const WCHAR* pwszRuntimeModule,
     [in] LIBRARY_PROVIDER_INDEX_TYPE indexType,
     [in] BYTE* pbBuildId,
     [in] int iBuildIdSize,
     [out] LPWSTR* ppResolvedModulePath);

Parametri

pwszFilename
[in] Nome del modulo richiesto.

pwszRuntimeModule
[in] Percorso del runtime o del modulo a file singolo.

indexType
[in] Tipo di informazioni sull'indice (pBuildId) specificato. Vedere l'enumerazione LIBRARY_PROVIDER_INDEX_TYPE.

pbBuildId
[in] ID di compilazione del modulo Linux o macOS. Può essere Null se si è verificato un errore durante il recupero dell'ID di compilazione.

iBuildIdSize
[in] Numero di byte nella matrice pbBuildId. Può essere 0 se si è verificato un errore durante il recupero dell'ID di compilazione.

ppResolvedModulePath
[out] Si tratta di un percorso con terminazione Null della DLL del modulo. In Unix deve essere allocata con CoTaskMemAlloc. In Unix deve essere allocata 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:

ProvideUnixLibrary 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 ProvideUnixLibrary 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