Метод ICOMAdminCatalog2::D umpApplicationInstance (comadmin.h)

Статья
08/22/2023

Создает файл дампа, содержащий изображение состояния указанного экземпляра приложения (процесса).

Примечание С Windows Server 2003 только администраторы имеют права доступа на чтение к файлам дампа COM+.

Синтаксис

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

Параметры

[in] bstrApplicationInstanceID

Идентификатор GUID экземпляра приложения.

[in] bstrDirectory

Полный путь к каталогу, в который помещается файл дампа. Не включайте имя файла. Если этот параметр имеет значение NULL, каталог по умолчанию — %SystemRoot%\system32\com\dmp.

[in] lMaxImages

Максимальное количество файлов дампа, которые могут существовать в каталоге дампа. Если указать эту переменную, файлы дампа не будут потреблять слишком много места в хранилище.

[out, retval] pbstrDumpFile

Имя файла дампа, содержащего результирующий образ экземпляра приложения.

Возвращаемое значение

Этот метод может возвращать стандартные возвращаемые значения E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED и E_FAIL, а также следующие значения.

Код возврата	Описание
S_OK	Метод завершился успешно.
COMADMIN_E_APP_NOT_RUNNING	Указанный процесс не выполняется.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	comadmin.h

См. также раздел

ICOMAdminCatalog2