Méthode ICLRDebuggingLibraryProvider3::ProvideWindowsLibrary

Article
11/20/2023

Obtient une interface de rappel de fournisseur de bibliothèque permettant la recherche et le chargement à la demande des bibliothèques de débogage spécifiques à la version du Common Language Runtime (CLR).

Syntaxe

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);

Paramètres

pwszFilename
[in] Nom du module demandé.

pwszRuntimeModule
[in] Chemin d’accès au runtime ou module à fichier unique.

indexType
[in] Type d’informations d’index (dwTimestamp/dwSizeOfImage) fournies. Consultez l’énumération LIBRARY_PROVIDER_INDEX_TYPE.

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

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