ICLRDebuggingLibraryProvider::ProvideLibrary Method

Gets a library provider callback interface that allows common language runtime (CLR) version-specific debugging libraries to be located and loaded on demand.

    HRESULT ProvideLibrary(
         [in] const WCHAR* pwszFileName,
         [in] DWORD dwTimestamp,
         [in] DWORD dwSizeOfImage,
         [out] HMODULE* hModule);

Parameters

• pwszFilename
  [in] The name of the module being requested .

• dwTimestamp
  [in] The date time stamp stored in the COFF file header of PE files.

• pLibraryProvider
  [in] The SizeOfImage field stored in the COFF optional file header of PE files.

• hModule
  [out] The handle to the requested module.

Return Value

This method returns the following specific HRESULTs as well as HRESULT errors that indicate method failure.

Remarks

ProvideLibrary allows the debugger to provide modules that are needed for debugging specific CLR files such as mscordbi.dll and mscordacwks.dll. The module handles have to remain valid until a call to the ICLRDebugging::CanUnloadNow method indicates that they may be freed, at which point it is the caller’s responsibility to free the handles.

The debugger may use any available means to locate or procure the debugging module.

Important

This feature allows the API caller to provide modules that contain executable, and possibly malicious, code. As a security precaution, the caller should not use ProvideLibrary to distribute any code that it is not willing to execute itself. If a serious security issue is discovered in an already released library, such as mscordbi.dll or mscordacwks.dll, the shim can be patched to recognize the bad versions of the files. The shim can then issue requests for the patched versions of the files and reject the bad versions if they are provided in response to any request. This can occur only if the user has patched to a new version of the shim. Unpatched versions will remain vulnerable.

Requirements

Platforms: See .NET Framework System Requirements.

Header: CorDebug.idl, CorDebug.h

Library: CorGuids.lib

.NET Framework Versions: 4

See Also

Other Resources

Debugging Interfaces

Debugging (Unmanaged API Reference)