IDkmBinaryLocator.LocateBinary Method

Definition

Namespace:

Microsoft.VisualStudio.Debugger.ComponentInterfaces

Assembly:

Microsoft.VisualStudio.Debugger.Engine.dll

Package:

Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

This method will search the local disk and any configured symbol servers for a binary that matches the parameters. The path to this file on the local disk is returned. If the file was on a symbol server, it is downloaded to a cache and the local path is returned.

public:
 System::String ^ LocateBinary(Microsoft::VisualStudio::Debugger::DkmProcess ^ process, System::String ^ applicationPath, System::String ^ dumpPath, System::String ^ originalPath, System::UInt32 timeDateStamp, System::UInt32 imageSize);

public string? LocateBinary (Microsoft.VisualStudio.Debugger.DkmProcess process, string applicationPath, string dumpPath, string originalPath, uint timeDateStamp, uint imageSize);

abstract member LocateBinary : Microsoft.VisualStudio.Debugger.DkmProcess * string * string * string * uint32 * uint32 -> string

Public Function LocateBinary (process As DkmProcess, applicationPath As String, dumpPath As String, originalPath As String, timeDateStamp As UInteger, imageSize As UInteger) As String

Parameters

process

DkmProcess

[In] DkmProcess represents a target process which is being debugged. The debugger debugs processes, so this is the basic unit of debugging. A DkmProcess can represent a system process or a virtual process such as minidumps.

applicationPath

String

[In] The original path to the exe stored in the minidump.

dumpPath

String

[In] The path to the dump file.

originalPath

String

[In] The original path to the binary stored in the minidump.

timeDateStamp

UInt32

[In] The time date stamp of the binary in the time_t format.

imageSize

UInt32

[In] The size of the image.

Returns

String

[Out,Optional] The path on the local disk of the local (or downloaded) binary.