Método ICOMAdminCatalog2::D umpApplicationInstance (comadmin.h)

Artículo
02/26/2024

Crea un archivo de volcado de memoria que contiene una imagen del estado de la instancia de aplicación especificada (proceso).

Nota A partir de Windows Server 2003, solo los administradores tienen privilegios de acceso de lectura a los archivos de volcado com+.

Sintaxis

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

Parámetros

[in] bstrApplicationInstanceID

GUID de la instancia de la aplicación.

[in] bstrDirectory

Ruta de acceso completa al directorio en el que se coloca el archivo de volcado. No incluya el nombre de archivo. Si este parámetro es NULL, el directorio predeterminado es %SystemRoot%\system32\com\dmp.

[in] lMaxImages

Número máximo de archivos de volcado de memoria que pueden existir en el directorio de volcado. Si se especifica esta variable, se impide que los archivos de volcado consuman demasiado espacio de almacenamiento.

[out, retval] pbstrDumpFile

Nombre del archivo de volcado de memoria que contiene la imagen de instancia de aplicación resultante.

Valor devuelto

Este método puede devolver los valores devueltos estándar E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED y E_FAIL, así como los siguientes valores.

Código devuelto	Descripción
S_OK	El método se completó correctamente.
COMADMIN_E_APP_NOT_RUNNING	El proceso especificado no se está ejecutando.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	comadmin.h

Consulte también

ICOMAdminCatalog2