IDebugClient5::GetRunningProcessDescription-Methode (dbgeng.h)

Artikel
02/06/2025

Die GetRunningProcessDescription- Methode gibt eine Beschreibung des Prozesses zurück, der den Namen des ausführbaren Bilds, die Dienstnamen, die MTS-Paketnamen und die Befehlszeile enthält.

Syntax

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

Parameter

[in] Server

Gibt den Prozessserver an, der nach der Prozessbeschreibung abfragen soll. Wenn Server- null ist, fragt das Modul Informationen zum lokalen Prozess direkt ab.

[in] SystemId

Gibt die Prozess-ID des Prozesses an, dessen Beschreibung gewünscht ist.

[in] Flags

Gibt einen Bitsatz mit Optionen an, die sich auf das Verhalten dieser Methode auswirken. Flags können die folgenden Bitkennzeichnungen enthalten:

Flagge	Beschreibung
DEBUG_PROC_DESC_NO_PATHS	Gibt nur Dateinamen ohne Pfadnamen zurück.
DEBUG_PROC_DESC_NO_SERVICES	Suchen Sie keine Dienstnamen nach.
DEBUG_PROC_DESC_NO_MTS_PACKAGES	Suchen Sie keine MTS-Paketnamen nach.
DEBUG_PROC_DESC_NO_COMMAND_LINE	Rufen Sie die Befehlszeile nicht ab.

[out, optional] ExeName

Empfängt den Namen der ausführbaren Datei, die zum Starten des Prozesses verwendet wird. Wenn ExeName-NULL-ist, werden diese Informationen nicht zurückgegeben.

[in] ExeNameSize

Gibt die Größe in Zeichen des Puffers ExeNameSizean. Diese Größe enthält den Abstand für das Endzeichen '\0'.

[out, optional] ActualExeNameSize

Empfängt die Größe in Zeichen des Dateinamens der ausführbaren Datei. Diese Größe enthält den Abstand für das Endzeichen '\0'. Wenn ExeNameSizeNULL-ist, werden diese Informationen nicht zurückgegeben.

[out, optional] Description

Empfängt zusätzliche Informationen zum Prozess, einschließlich Dienstnamen, MTS-Paketnamen und der Befehlszeile. Wenn DescriptionNULL-ist, werden diese Informationen nicht zurückgegeben.

[in] DescriptionSize

Gibt die Größe in Zeichen des Puffers Beschreibungan. Diese Größe enthält den Abstand für das Endzeichen '\0'.

[out, optional] ActualDescriptionSize

Empfängt die Größe in Zeichen der zusätzlichen Informationen. Diese Größe enthält den Abstand für das Endzeichen '\0'. Wenn ActualDescriptionSizeNULL-ist, werden diese Informationen nicht zurückgegeben.

Rückgabewert

Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte.

Rückgabecode	Beschreibung
S_OK	Die Methode war erfolgreich.
S_FALSE	Die Methode war erfolgreich. Allerdings waren ExeNameSize oder DescriptionSize kleiner als die Größe der jeweiligen Zeichenfolge und die Zeichenfolge wurde abgeschnitten, um in den Puffer einzupassen.