CaptureDumpFileOnDevice

Other versions of this page are also available for the following:

• Windows Embedded CE 6.0 R3

8/27/2008

This function captures a dump file on the device.

Syntax

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 privileged.

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

  dwProcessId	dwThreadId	Thread Context for capture
  0	0	Current process, current thread.
  0	>0	Current process, specified thread. The specified thread must be one of the following: Owned by the current, privileged or unprivileged, process - or - Running in the current privileged process.
  >0	0	Specified process, last created thread.
  >0	>0	Specified 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 Value

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

Header	pkfuncs.h
Library	coredll.lib
Windows Embedded CE	Windows CE 5.0 and later

See Also

Other Resources

ReportFault