Compartir a través de


Método IDebugClient2::GetRunningProcessDescription (dbgeng.h)

El método GetRunningProcessDescription devuelve una descripción del proceso que incluye el nombre de la imagen ejecutable, los nombres de servicio, los nombres de paquete MTS y la línea de comandos.

Sintaxis

HRESULT GetRunningProcessDescription(
  [in]            ULONG64 Server,
  [in]            ULONG   SystemId,
  [in]            ULONG   Flags,
  [out, optional] PSTR    ExeName,
  [in]            ULONG   ExeNameSize,
  [out, optional] PULONG  ActualExeNameSize,
  [out, optional] PSTR    Description,
  [in]            ULONG   DescriptionSize,
  [out, optional] PULONG  ActualDescriptionSize
);

Parámetros

[in] Server

Especifica el servidor de procesos que se va a consultar para la descripción del proceso. Si Server es cero, el motor consultará información sobre el proceso local directamente.

[in] SystemId

Especifica el identificador de proceso del proceso cuya descripción se desea.

[in] Flags

Especifica un conjunto de bits que contiene opciones que afectan al comportamiento de este método. Las marcas pueden contener las marcas de bits siguientes:

Marca Descripción
DEBUG_PROC_DESC_NO_PATHS Devuelve solo nombres de archivo sin nombres de ruta de acceso.
DEBUG_PROC_DESC_NO_SERVICES No busque nombres de servicio.
DEBUG_PROC_DESC_NO_MTS_PACKAGES No busque nombres de paquete MTS.
DEBUG_PROC_DESC_NO_COMMAND_LINE No recupere la línea de comandos.

[out, optional] ExeName

Recibe el nombre del archivo ejecutable usado para iniciar el proceso. Si ExeName es NULL, esta información no se devuelve.

[in] ExeNameSize

Especifica el tamaño en caracteres del búfer ExeNameSize. Este tamaño incluye el espacio para el carácter de terminación '\0'.

[out, optional] ActualExeNameSize

Recibe el tamaño en caracteres del nombre de archivo ejecutable. Este tamaño incluye el espacio para el carácter de terminación '\0'. Si ExeNameSize es NULL, esta información no se devuelve.

[out, optional] Description

Recibe información adicional sobre el proceso, incluidos los nombres de servicio, los nombres de paquete MTS y la línea de comandos. Si Description es NULL, esta información no se devuelve.

[in] DescriptionSize

Especifica el tamaño en caracteres de la descripción del búfer. Este tamaño incluye el espacio para el carácter de terminación '\0'.

[out, optional] ActualDescriptionSize

Recibe el tamaño en caracteres de la información adicional. Este tamaño incluye el espacio para el carácter de terminación '\0'. Si ActualDescriptionSize es NULL, esta información no se devuelve.

Valor devuelto

Este método también puede devolver valores de error. Consulte Valores devueltos para obtener más detalles.

Código devuelto Descripción
S_OK
Método realizado correctamente.
S_FALSE
Método realizado correctamente. Sin embargo, ExeNameSize o DescriptionSize eran menores que el tamaño de la cadena respectiva y la cadena se truncaba para caber dentro del búfer.

Comentarios

Este método solo está disponible para la depuración en modo usuario activo.

Para obtener más información sobre cómo crear y adjuntar a destinos en modo de usuario activo, consulte Destinos de Live User-Mode.

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado dbgeng.h (include Dbgeng.h)

Consulte también

AttachProcess

ConnectProcessServer

CreateProcessAndAttach2

GetRunningProcessSystemIdByExecutableName

GetRunningProcessSystemIds

IDebugClient

IDebugClient2

IDebugClient3

IDebugClient4

IDebugClient5