Método IDebugClient5::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. Marcas puede contener las marcas de bits siguientes:
| Bandera | Descripción |
|---|---|
| DEBUG_PROC_DESC_NO_PATHS | Devuelve solo los 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, no se devuelve esta información.
[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, no se devuelve esta información.
[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 descripción es NULL, esta información no se devuelve.
[in] DescriptionSize
Especifica el tamaño en caracteres del búfer Descripción. 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 información.
| Código devuelto | Descripción |
|---|---|
|
El método se realizó correctamente. |
|
El método se realizó 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. |
Observaciones
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 destinos en modo de usuario activo, consulte Live User-Mode Targets.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | dbgeng.h (include Dbgeng.h) |