IDebugClient：：GetRunningProcessDescription 方法（dbgeng.h）

發行項
02/06/2025

GetRunningProcessDescription 方法會傳回包含可執行映射名稱、服務名稱、MTS 套件名稱和命令行的程式描述。

語法

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
);

參數

[in] Server

指定要查詢進程描述的進程伺服器。如果 伺服器 為零，引擎會直接查詢本機進程的相關信息。

[in] SystemId

指定需要其描述之進程的進程標識碼。

[in] Flags

指定位集，其中包含影響這個方法行為的選項。旗標可以包含下列位旗標：

旗	描述
DEBUG_PROC_DESC_NO_PATHS	只傳回沒有路徑名稱的檔名。
DEBUG_PROC_DESC_NO_SERVICES	請勿查閱服務名稱。
DEBUG_PROC_DESC_NO_MTS_PACKAGES	請勿查閱 MTS 套件名稱。
DEBUG_PROC_DESC_NO_COMMAND_LINE	請勿擷取命令行。

[out, optional] ExeName

接收用來啟動進程的可執行檔名稱。如果 ExeNameNULL，則不會傳回此資訊。

[in] ExeNameSize

指定緩衝區的大小，ExeNameSize。此大小包含『\0』終止字元的空間。

[out, optional] ActualExeNameSize

接收可執行檔名稱的字元大小。此大小包含『\0』終止字元的空間。如果 ExeNameSizeNULL，則不會傳回此資訊。

[out, optional] Description

接收進程的額外資訊，包括服務名稱、MTS 套件名稱和命令行。如果描述NULL，則不會傳回此資訊。

[in] DescriptionSize

指定緩衝區的大小，Description。此大小包含『\0』終止字元的空間。

[out, optional] ActualDescriptionSize

接收額外資訊的字元大小。此大小包含『\0』終止字元的空間。如果 ActualDescriptionSizeNULL，則不會傳回此資訊。

傳回值

這個方法也可能傳回錯誤值。如需詳細資訊，請參閱傳回值。

傳回碼	描述
S_OK	方法成功。
S_FALSE	方法成功。不過，ExeNameSize 或 DescriptionSize 小於個別字串的大小，而且字元串已截斷以符合緩衝區內。