Methode ICLRDebuggingLibraryProvider::P rovideLibrary

Artikel
05/10/2023

Hiermee haalt u een callback-interface van de bibliotheekprovider op waarmee common language runtime (CLR) versiespecifieke foutopsporingsbibliotheken op aanvraag kunnen worden gevonden en geladen.

Syntaxis

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

Parameters

pwszFilename
[in] De naam van de module die wordt aangevraagd.

dwTimestamp
[in] De datum-tijdstempel die is opgeslagen in de COFF-bestandskoptekst van PE-bestanden.

dwSizeOfImage
[in] Het SizeOfImage veld dat is opgeslagen in de optionele COFF-bestandsheader van PE-bestanden.

hModule
[uit] De ingang van de aangevraagde module.

Retourwaarde

Deze methode retourneert de volgende specifieke HRESULT's en HRESULT-fouten die wijzen op een methodefout.

HRESULT	Beschrijving
S_OK	De methode is voltooid.

Uitzonderingen

Opmerkingen

ProvideLibrary biedt het foutopsporingsprogramma modules die nodig zijn voor het opsporen van fouten in specifieke CLR-bestanden, zoals mscordbi.dll en mscordacwks.dll. De module-ingangen moeten geldig blijven totdat een aanroep van de methode ICLRDebugging::CanUnloadNow aangeeft dat ze mogelijk worden vrijgemaakt. Op dat moment is het de verantwoordelijkheid van de aanroeper om de ingangen vrij te maken.

Het foutopsporingsprogramma kan alle beschikbare middelen gebruiken om de foutopsporingsmodule te vinden of aan te schaffen.

Belangrijk

Met deze functie kan de API-aanroeper modules leveren die uitvoerbare en mogelijk schadelijke code bevatten. Als veiligheidsmaatregel mag de aanroeper niet gebruiken ProvideLibrary om code te distribueren die niet zelf wil worden uitgevoerd.

Als er een ernstig beveiligingsprobleem wordt gedetecteerd in een reeds uitgebrachte bibliotheek, zoals mscordbi.dll of mscordacwks.dll, kan de shim worden gepatcht om de slechte versies van de bestanden te herkennen. De shim kan vervolgens aanvragen uitgeven voor de gepatchte versies van de bestanden en de slechte versies weigeren als deze worden opgegeven als reactie op een aanvraag. Dit kan alleen gebeuren als de gebruiker een patch heeft uitgevoerd naar een nieuwe versie van de shim. Niet-gepatchte versies blijven kwetsbaar.

Vereisten

Platforms: Zie Systeemvereisten.

Header: CorDebug.idl, CorDebug.h

Bibliotheek: CorGuids.lib

.NET Framework versies: beschikbaar sinds 4

Delen via