CrashRpt Structures

Classes
struct	tagCR_EXCEPTION_INFO
struct	CR_INSTALL_INFOW
	This structure defines the general information used by crInstall() More...
struct	CR_INSTALL_INFOA
Typedefs
typedef CR_INSTALL_INFOA	CR_INSTALL_INFO
	Character set-independent mapping of CR_INSTALL_INFOW and CR_INSTALL_INFOA structures.
typedef struct tagCR_EXCEPTION_INFO	CR_EXCEPTION_INFO

---

Typedef Documentation

typedef struct tagCR_EXCEPTION_INFO CR_EXCEPTION_INFO

This structure defines the information needed to generate crash minidump file and provide the developer with other information about the error. This structure is used by the crGenerateErrorReport() function.

cb [in]

This must contain the size of this structure in bytes.

pexcptrs [in, optional]

Should contain the exception pointers. If this parameter is NULL, the current CPU state is used to generate exception pointers.

exctype [in]

The type of exception. This parameter may be one of the following:

• CR_SEH_EXCEPTION SEH (Structured Exception Handling) exception
• CR_CPP_TERMINATE_CALL C++ terminate() function call
• CR_CPP_UNEXPECTED_CALL C++ unexpected() function call
• CR_CPP_PURE_CALL Pure virtual method call (Visual Studio .NET 2003 and later)
• CR_CPP_NEW_OPERATOR_ERROR C++ 'new' operator error (Visual Studio .NET 2003 and later)
• CR_CPP_SECURITY_ERROR Buffer overrun (Visual Studio .NET 2003 only)
• CR_CPP_INVALID_PARAMETER Invalid parameter error (Visual Studio 2005 and later)
• CR_CPP_SIGABRT C++ SIGABRT signal
• CR_CPP_SIGFPE C++ floating point exception
• CR_CPP_SIGILL C++ illegal instruction
• CR_CPP_SIGINT C++ SIGINT signal
• CR_CPP_SIGSEGV C++ invalid storage access
• CR_CPP_SIGTERM C++ termination request

code [in, optional]

Used if exctype is CR_SEH_EXCEPTION and represents the SEH exception code. If pexptrs is NULL, this value is used when generating exception information for initializing pexptrs->ExceptionRecord->ExceptionCode member, otherwise it is ignored.

fpe_subcode [in, optional]

Used if exctype is equal to CR_CPP_SIGFPE. It defines the floating point exception subcode (see signal() function ducumentation in MSDN).

expression, function, file and line [in, optional]

These parameters are used when exctype is CR_CPP_INVALID_PARAMETER. These members are typically non-zero when using debug version of CRT.

bManual [in]

Since v.1.2.4, bManual parameter should be equal to TRUE if the report is generated manually. The value of bManual parameter affects the automatic application restart behavior. If the application restart is requested by the CR_INST_APP_RESTART flag of CR_INSTALL_INFO::dwFlags structure member, and if bManual is FALSE, the application will be restarted after error report generation. If bManual is TRUE, the application won't be restarted.

hSenderProcess [out]

As of v.1.2.8, hSenderProcess parameter will contain the handle to the CrashSender.exe process when crGenerateErrorReport function returns. The caller may use this handle to wait until CrashSender.exe process exits and check the exit code.

typedef CR_INSTALL_INFOA CR_INSTALL_INFO

Character set-independent mapping of CR_INSTALL_INFOW and CR_INSTALL_INFOA structures.

Definition at line 588 of file CrashRpt.h.