CaptureDumpFileOnDevice (Windows Embedded CE 6.0)
1/5/2010
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.
- Owned by the current, privileged or unprivileged, 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 |