CaptureDumpFileOnDevice (Windows CE 5.0)

Windows CE 5.0
Send Feedback

This function captures a dump file on the device.

BOOL CaptureDumpFileOnDevice(
  DWORD dwProcessId,
  DWORD dwThreadId, 
  LPCWSTR pwzExtraFilesPath
);

Parameters

dwProcessId
[in] ID of the process to capture. Forced to 0 if the application is not trusted.

The following table explains the relationship between values for dwProcessId and dwThreadId, and the thread context for capture.

dwProcessIddwThreadIdThread Context for capture
00Current process, current thread.
0>0Current process, specified thread.

The specified thread must be owned by the current process, whether trusted or untrusted, or be running in the current trusted process.

>00Specified process, last created thread.
>0>0Specified process, specified thread.

The specified thread must be owned by or running in the specified process.

dwThreadId
[in] ID of the thread to capture.
pwzExtraFilesPath
[in] Optional. Path to a temporary directory of additional files that should be included with the dump when uploaded to the Watson web site.

Ownership of the temporary directory transfers to the Error Report Generator after CaptureDumpFileOnDevice returns success.

The calling function

  • Should not use the directory again if this method is successful.
  • Should always create a directory with a unique name, and the directory must be a subfolder within the directory specified in the ExtraFilesDirectory value of the DumpSettings registry key.

Return Values

Returns TRUE if the function was successful.

If CaptureDumpFileOnDevice returns FALSE, use GetLastError to discover more information.

Remarks

To use CaptureDumpFileOnDevice, set WINCEOEM=1.

Requirements

OS Versions: Windows CE 5.0 and later.
Header: Pkfuncs.h.
Link Library: Coredll.lib.

See Also

ReportFault


Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.


Show: