ICLRDebuggingLibraryProvider3::P rovideWindowsLibrary (método)

Obtiene una interfaz de devolución de llamada del proveedor de biblioteca que permite que las bibliotecas de depuración específicas de versiones de Common Language Runtime (CLR) se encuentren y carguen a petición.

Sintaxis

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

Parámetros

pwszFilename
[in] Nombre del módulo que se solicita.

pwszRuntimeModule
[in] Ruta de acceso del módulo runtime o de un solo archivo.

indexType
[in] Tipo de información de índice (dwTimestamp/dwSizeOfImage) proporcionada. Consulte LIBRARY_PROVIDER_INDEX_TYPE enumeración.

dwTimestamp
[in] Marca de fecha y hora almacenada en el encabezado de archivo COFF de archivos PE.

dwSizeOfImage
[in] Campo SizeOfImage almacenado en el encabezado de archivo opcional COFF de archivos PE.

ppResolvedModulePath
[out] Se trata de una ruta de acceso terminada nula al archivo DLL del módulo. En Windows, debe asignarse con CoTaskMemAlloc. En Unix, debe asignarse con malloc. El error deja intacto. Consulte la nota de seguridad a continuación.

Valor devuelto

Este método devuelve los siguientes errores HRESULT y HRESULT específicos que indican un error del método.

HRESULT	Descripción
S_OK	El método se completó correctamente.

Observaciones

ProvideWindowsLibrary permite al depurador proporcionar módulos necesarios para depurar archivos CLR específicos, como mscordbi.dll y mscordacwks.dll.

El depurador puede usar cualquier medio disponible para buscar o adquirir el módulo de depuración.

Importante

Esta característica permite al autor de la llamada de API proporcionar módulos que contienen código ejecutable y, posiblemente, malintencionado. Como precaución de seguridad, el autor de la llamada no debe usar ProvideWindowsLibrary para distribuir ningún código que no esté dispuesto a ejecutarse a sí mismo.

Si se detecta un problema de seguridad grave en una biblioteca ya publicada, como mscordbi.dll o mscordacwks.dll, la corrección de compatibilidad se puede aplicar revisiones para reconocer las versiones incorrectas de los archivos. Después, las correcciones de compatibilidad pueden emitir solicitudes para las versiones revisadas de los archivos y rechazar las versiones incorrectas si se proporcionan en respuesta a cualquier solicitud. Esto solo puede ocurrir si el usuario ha revisado a una nueva versión de la corrección de compatibilidad. Las versiones no publicadas seguirán siendo vulnerables.

Requisitos

Plataformas: Consulte Sistemas operativos compatibles con .NET.

Encabezado: dbgshim.h

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

Versiones de .NET: Disponible desde .NET Core 2.1