Share via

InitDmpTxt (Windows Embedded CE 6.0)

  • Article

1/5/2010

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
Windows Embedded CE Windows CE 5.0 and later

See Also

Reference

CloseDmpTxt
GetDmpLines
GetDmpInfo

Concepts

Report Upload Client Functions