Share via


InitDmpTxt (Compact 2013)

3/26/2014

This function opens the dump file and populates allocated structures with relevant data.

Syntax

HRESULT InitDmpTxt(
  LPCWSTR pwzFilePath,
  DWORD dwMaxCharsPerLine,
  DWORD* pdwTotalLines,
  HANDLE* phDmpFile
);

Parameters

  • pwzFilePath
    [in] Full path to the file for viewing.
  • dwMaxCharsPerLine
    [in] Maximum characters to display per line in the user interface, excluding the carriage return.

    Minimum value is 27 characters.

  • pdwTotalLines
    [out] Total lines for display.
  • phDmpFile
    [out] Pointer to DMPFILEINFO structures used to access the dump file contents from other function calls.

Return Value

The following table shows return values for this function.

Value

Description

S_OK

Function successful.

E_FAIL

Unspecified failure.

Remarks

The phDmpFile parameter is not a conventional file handle.

After use, close by calling CloseDmpTxt.

You can set the dwMaxCharsPerLine parameter to 0, in which case GetDmpLinesis not called. This is useful if you call only GetDmpInfo. The calling function must still close the handle with a call to CloseDmpTxt.

Requirements

Header

dwdmptxt.h

Library

dwdmptxt.lib

See Also

Reference

Report Upload Client Functions
CloseDmpTxt
GetDmpLines
GetDmpInfo