DEBUGINFO.COM

    BOOL __stdcall CreateDump
    ( 
      DWORD                ProcessId, 
      LPCWSTR              pFileName, 
      DWORD                DumpType, 
      DWORD                ExcThreadId, 
      EXCEPTION_POINTERS*  pExcPtrs 
    );

Parameters:

ProcessId

Process id of the target process (use GetCurrentProcessId function or its .NET equivalent if you want to create a minidump of the current process)

pFileName

Name of the minidump file

DumpType

Kinds of information that should be included into the minidump, represented by a set of MiniDump* flags (members of MINIDUMP_TYPE enumeration). You can find more information about MiniDump* flags in this article. In most cases, the value of zero (equivalent of MiniDumpNormal flag) is sufficient.

ExcThreadId

Thread id of the thread that generated the exception. Required only if pExcPtrs parameter is not null, otherwise ignored.

pExcPtrs

Pointer to EXCEPTION_POINTERS structure that describes the current exception. This parameter is required only if you call CreateDump from an exception filter, otherwise it can be null. Note that if you are interested only in managed functions on the call stack, this parameter can be set to null.

Return value:

TRUE if succeeded, FALSE if failed. If the function fails, GetLastError can be used to obtain the error code.

Description:

This function produces a minidump of the specified process (current or external, identified by process id). Optional exception information can be specified.

Note: Creating a minidump of another process requires binding to the same version of .NET Runtime as loaded by the target process. Since binding cannot be undone after it has been performed, the current process cannot be used to create minidumps of processes that use different versions of .NET Runtime. A simple solution is to start a new process to create minidumps (e.g. use ClrDump.exe).

    BOOL __stdcall RegisterFilter
    ( 
      LPCWSTR  pFileName, 
      DWORD    DumpType 
    );

Parameters:

pFileName

Name of the minidump file

DumpType

Kinds of information that should be included into the minidump, represented by a set of MiniDump* flags (members of MINIDUMP_TYPE enumeration). You can find more information about MiniDump* flags in this article. In most cases, the value of zero (equivalent of MiniDumpNormal flag) is sufficient.

Return value:

TRUE if succeeded, FALSE if failed. If the function fails, GetLastError can be used to obtain the error code.

Description:

Registers a custom filter for unhandled exceptions in the current process (see SetUnhandledExceptionFilter function for more information about custom filters). If the process crashes with unhandled exception (it can be native or managed exception), the filter catches it and creates a minidump (with the specified file name).

Note: Managed debugging can be affected. If the filter is registered and the application is running under managed-only debugger, the debugger will not receive notifications about unhandled exceptions in the application (by the nature of managed debugging architecture, which relies on its own custom filter for unhandled exceptions to notify the debugger). A typical solution is to register the custom filter (call RegisterFilter) only if you are not going to debug the application (for example, filter registration can be enabled/disabled via an application-specific configuration setting).

    BOOL __stdcall UnregisterFilter();

Return value:

TRUE if succeeded, FALSE if failed. If the function fails, GetLastError can be used to obtain the error code.

Description:

Unregisters the custom filter for unhandled exceptions (registered with a call to RegisterFilter).

    DWORD __stdcall SetFilterOptions( DWORD Options );

Parameters:

Options

Filter options (combination of flags that specify whether the particular option should be turned on or off)

CLRDMP_OPT_CALLDEFAULTHANDLER (0x1)

After creating the minidump, pass control to the default (system-provided) exception handler. The default handler will report the error to the user (using the standard Windows Error Reporting dialog) and/or launch the registered just-in-time debugger. This option is turned off by default.

Return value:

The previously active options.

Description:

Sets or clears options that allow to configure various aspects of the custom filter's functionality.

[DllImport("clrdump.dll", CharSet = CharSet.Unicode, SetLastError=true)]
static extern Int32 CreateDump( Int32 ProcessId, string FileName, 
    Int32 DumpType, Int32 ExcThreadId, IntPtr ExtPtrs );

[DllImport("clrdump.dll", CharSet = CharSet.Unicode, SetLastError=true)]
static extern Int32 RegisterFilter( string FileName, Int32 DumpType );

[DllImport("clrdump.dll", SetLastError=true)]
static extern Int32 UnregisterFilter();

[DllImport("clrdump.dll")]
static extern Int32 SetFilterOptions(Int32 Options);