ICLRDebuggingLibraryProvider3::P ProvideWindowsLibrary-Methode

Artikel
11/25/2023

Ruft eine Bibliotheksanbieter-Rückrufschnittstelle ab, die es ermöglicht, versionsspezifische Common Language Runtime (CLR)-Debugbibliotheken bei Bedarf zu suchen und zu laden.

Syntax

HRESULT ProvideWindowsLibrary (
     [in] const WCHAR* pwszFileName,
     [in] const WCHAR* pwszRuntimeModule,
     [in] LIBRARY_PROVIDER_INDEX_TYPE indexType,
     [in] DWORD dwTimestamp,
     [in] DWORD dwSizeOfImage,
     [out] LPWSTR* ppResolvedModulePath);

Parameter

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

pwszRuntimeModule
[in] Der Runtime- oder Einzeldateimodulpfad.

indexType
[in] Der Typ der bereitgestellten Indexinformationen (dwTimestamp/dwSizeOfImage). Siehe LIBRARY_PROVIDER_INDEX_TYPE-Enumeration.

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

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