(dbgeng.h) IDebugClient5：：GetRunningProcessDescription 方法

發行項
02/23/2024

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

指定要查詢進程描述的進程伺服器。如果 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

接收用來啟動進程的可執行檔名稱。如果 ExeName 為 NULL，則不會傳回這項資訊。

[in] ExeNameSize

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

[out, optional] ActualExeNameSize

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

[out, optional] Description

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

[in] DescriptionSize

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

[out, optional] ActualDescriptionSize

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

傳回值

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

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