ICOMAdminCatalog2::DumpApplicationInstance method (comadmin.h)

Creates a dump file containing an image of the state of the specified application instance (process).

Note  As of Windows Server 2003, only administrators have read access privileges to the COM+ dump files.

 

Syntax

HRESULT DumpApplicationInstance(
  [in]          BSTR bstrApplicationInstanceID,
  [in]          BSTR bstrDirectory,
  [in]          long lMaxImages,
  [out, retval] BSTR *pbstrDumpFile
);

Parameters

[in] bstrApplicationInstanceID

The GUID of the application instance.

[in] bstrDirectory

The complete path to the directory into which the dump file is placed. Do not include the file name. If this parameter is NULL, the default directory is %SystemRoot%\system32\com\dmp.

[in] lMaxImages

The maximum number of dump files that may exist in the dump directory. Specifying this variable prevents dump files from consuming too much storage space.

[out, retval] pbstrDumpFile

The name of the dump file containing the resulting application instance image.

Return value

This method can return the standard return values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, and E_FAIL, as well as the following values.

Return code	Description
S_OK	The method completed successfully.
COMADMIN_E_APP_NOT_RUNNING	The specified process is not running.

Requirements

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	comadmin.h

See also

ICOMAdminCatalog2