Méthode ICLRDebuggingLibraryProvider2::ProvideLibrary2

Article
10/03/2023

Permet au débogueur de fournir un chemin d’accès à une bibliothèque de débogage CLR (Common Language Runtime) spécifique de la version.

Syntaxe

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

Paramètres

pwszFilename
[in] Nom du module demandé.

dwTimestamp
[in] Timestamp de la date stocké dans l’en-tête de fichier COFF des fichiers PE.

dwSizeOfImage
[in] Champ SizeOfImage stocké dans l’en-tête de fichier facultatif COFF des fichiers PE.

ppResolvedModulePath
[out] Il s’agit d’un chemin d’accès arrêté null vers la DLL du module. Sur Windows, il doit être alloué avec CoTaskMemAlloc. Sur Unix, il doit être alloué avec malloc. Un échec le laisse intouché. Voir la note de sécurité ci-dessous !

Valeur retournée

Cette méthode retourne les HRESULT spécifiques suivants ainsi que les erreurs HRESULT indiquant l’échec de la méthode.

HRESULT	Description
`S_OK`	La commande s'est correctement terminée.

Notes

ProvideLibrary2 permet au débogueur de fournir les modules nécessaires pour le débogage de fichiers CLR spécifiques, comme mscordbi.dll et mscordacwks.dll.

Le débogueur peut utiliser tous les moyens disponibles pour localiser ou se procurer le module de débogage.

Important

Cette fonctionnalité permet à l’appelant d’API de fournir des modules qui contiennent un exécutable, et éventuellement du code malveillant. En guise de précaution de sécurité, l’appelant ne doit pas utiliser ProvideLibrary2 pour distribuer tout code qu’il n’est pas prêt à s’exécuter lui-même.

Si un problème de sécurité sérieux est détecté dans une bibliothèque déjà publiée, par exemple mscordbi.dll ou mscordacwks.dll, le shim peut être corrigé pour reconnaître les versions incorrectes des fichiers. Le shim peut ensuite émettre des demandes pour les versions corrigées des fichiers et rejeter les versions incorrectes si elles sont fournies en réponse à toute demande. Cela peut se produire uniquement si l’utilisateur a mis à jour une nouvelle version du shim. Les versions non mises à jour restent vulnérables.

Spécifications

Plateformes : Consultez Systèmes d’exploitation pris en charge par .NET.

En-tête : dbgshim.h

Bibliothèque : dbgshim.dll, libdbgshim.so, libdbgshim.dylib

Versions de .NET : Disponibles depuis .NET Core 2.1

Partager via