Partager via

ICLRDebuggingLibraryProvider2 ::P rovideLibrary2, méthode

Permet au débogueur de fournir un chemin d’accès à une bibliothèque de débogage CLR (Common Language Runtime) spécifique à 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] Horodatage de 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 de module. Sur Windows, il doit être alloué avec CoTaskMemAlloc. Sur Unix, il doit être alloué avec malloc. L’échec le laisse intouché. Voir la note de sécurité ci-dessous !

Valeur retournée

Cette méthode retourne les erreurs HRESULT spécifiques suivantes, ainsi que les erreurs HRESULT qui indiquent une défaillance de méthode.

HRESULT Descriptif
S_OK La méthode s’est terminée avec succès.

Remarques

ProvideLibrary2 permet au débogueur de fournir des modules nécessaires au débogage de fichiers CLR spécifiques tels que mscordbi.dll et mscordacwks.dll.

Le débogueur peut utiliser tous les moyens disponibles pour localiser ou acheter 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 de code qu’il n’est pas prêt à s’exécuter lui-même.

Si un problème de sécurité grave 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 à une demande. Cela peut se produire uniquement si l’utilisateur a corrigé une nouvelle version du shim. Les versions non corrigés restent vulnérables.

Spécifications

Plates-formes: Consultez les 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 : Disponible depuis .NET Core 2.1

  • Last updated on