Поделиться через


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

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

Примечание С 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