ICLRDebuggingLibraryProvider2::P rovideLibrary2-Methode

Artikel
03/03/2024

Ermöglicht dem Debugger, einen Pfad zu einer versionsspezifischen Common Language Runtime(CLR)-Debugbibliothek bereitzustellen.

Syntax

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

Parameter

pwszFilename
[in] Der Name des Moduls, das angefordert wird.

dwTimestamp
[in] Der im COFF-Dateiheader von PE-Dateien gespeicherte Datumszeitstempel.

dwSizeOfImage
[in] Das SizeOfImage-Feld, das im optionalen COFF-Dateiheader von PE-Dateien gespeichert ist.

ppResolvedModulePath
[out] Dies ist ein mit NULL beendeter Pfad zur Modul-DLL. Unter Windows sollte eine Zuordnung zu CoTaskMemAlloc erfolgen. Unter Unix sollte eine Zuordnung zu malloc erfolgen. Es bleibt von Fehlern unberührt. Siehe Sicherheitshinweis weiter unten!

Rückgabewert

Diese Methode gibt das folgende spezifische HRESULT sowie HRESULT-Fehler zurück, die Methodenfehler anzeigen.

HRESULT	BESCHREIBUNG
`S_OK`	Die Methode wurde erfolgreich abgeschlossen.

Hinweise

ProvideLibrary2 ermöglicht es dem Debugger, Module bereitzustellen, die zum Debuggen bestimmter CLR-Dateien wie mscordbi.dll und mscordacwks.dll erforderlich sind.

Der Debugger kann alle verfügbaren Mittel verwenden, um das Debugmodul zu suchen oder zu beschaffen.

Wichtig

Mit diesem Feature kann der API-Aufrufer Module bereitstellen, die ausführbaren und möglicherweise schädlichen Code enthalten. Als Sicherheitsvorkehrung sollte der Aufrufer nicht ProvideLibrary2 verwenden, um Code zu verteilen, der nicht bereit ist, sich selbst auszuführen.

Wenn ein schwerwiegendes Sicherheitsproblem in einer bereits veröffentlichten Bibliothek entdeckt wird, z. B. mscordbi.dll oder mscordacwks.dll, kann der Shim gepatcht werden, um die ungültigen Versionen der Dateien zu erkennen. Der Shim kann dann Anforderungen für die gepatchten Versionen der Dateien ausstellen und die ungültigen Versionen ablehnen, wenn sie als Antwort auf eine Anforderung bereitgestellt werden. Dies kann nur auftreten, wenn der Benutzer auf eine neue Version des Shim gepatcht hat. Nicht gepatchte Versionen bleiben anfällig.

Anforderungen

Plattformen: Siehe Von .NET unterstützte Betriebssysteme.

Header: dbgshim.h

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

.NET-Versionen: verfügbar seit .NET Core 2.1

Freigeben über