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

Artículo
08/07/2023

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.