IDkmBinaryLocator11a.TryLocateBinary Method

Definition

Namespace:

Microsoft.VisualStudio.Debugger.ComponentInterfaces

Assembly:

Microsoft.VisualStudio.Debugger.Engine.dll

Package:

Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

Called to initiate locating of binaries whose images might not have previously found or attempted to be loaded. 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 ^ TryLocateBinary(Microsoft::VisualStudio::Debugger::DkmProcess ^ process, System::String ^ applicationPath, System::String ^ dumpPath, System::String ^ originalPath, System::UInt32 timeDateStamp, System::UInt32 imageSize);

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

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

Public Function TryLocateBinary (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.