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

bstrApplicationInstanceID [in]

The GUID of the application instance.

bstrDirectory [in]

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.

lMaxImages [in]

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.

pbstrDumpFile [out]

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.

Requirements

See Also

ICOMAdminCatalog2

Send comments about this topic to Microsoft

Build date: 11/19/2009