DkmProcess.TryLocateBinary(String, String, String, UInt32, UInt32) Method

Definition

Namespace:

Microsoft.VisualStudio.Debugger

Assembly:

Microsoft.VisualStudio.Debugger.Engine.dll

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.

This API was introduced in Visual Studio 11 Update 1 (DkmApiVersion.VS11FeaturePack1).

public:
 System::String ^ TryLocateBinary(System::String ^ ApplicationPath, System::String ^ DumpPath, System::String ^ OriginalPath, System::UInt32 TimeDateStamp, System::UInt32 ImageSize);

public:
 Platform::String ^ TryLocateBinary(Platform::String ^ ApplicationPath, Platform::String ^ DumpPath, Platform::String ^ OriginalPath, unsigned int TimeDateStamp, unsigned int ImageSize);

std::wstring TryLocateBinary(std::wstring const & ApplicationPath, std::wstring const & DumpPath, std::wstring const & OriginalPath, unsigned int TimeDateStamp, unsigned int ImageSize);

public string TryLocateBinary (string ApplicationPath, string DumpPath, string OriginalPath, uint TimeDateStamp, uint ImageSize);

member this.TryLocateBinary : string * string * string * uint32 * uint32 -> string

Public Function TryLocateBinary (ApplicationPath As String, DumpPath As String, OriginalPath As String, TimeDateStamp As UInteger, ImageSize As UInteger) As String

Parameters

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.