IDebugClient2::GetRunningProcessSystemIdByExecutableName-Methode (dbgeng.h)

Die GetRunningProcessSystemIdByExecutableName-Methode sucht nach einem Prozess mit einem bestimmten ausführbaren Dateinamen und gibt die Prozess-ID zurück.

Syntax

HRESULT GetRunningProcessSystemIdByExecutableName(
  [in]  ULONG64 Server,
  [in]  PCSTR   ExeName,
  [in]  ULONG   Flags,
  [out] PULONG  Id
);

Parameter

[in] Server

Gibt den Prozessserver an, der nach dem ausführbaren Namen suchen soll. Wenn Server null ist, sucht das Modul nach dem ausführbaren Namen zwischen den Prozessen, die auf dem lokalen Computer ausgeführt werden.

[in] ExeName

Gibt den Dateinamen der ausführbaren Datei an, nach der gesucht werden soll.

[in] Flags

Gibt einen Bitsatz an, der steuert, wie der ausführbare Name übereinstimmt. Die folgenden Kennzeichen sind möglicherweise vorhanden:

Flag Beschreibung
DEBUG_GET_PROC_FULL_MATCH ExeName gibt den vollständigen Pfadnamen des ausführbaren Dateinamens an.

Wenn dieses Kennzeichen nicht festgelegt ist, verwendet diese Methode beim Suchen nach dem Prozess keine Pfadnamen.

DEBUG_GET_PROC_ONLY_MATCH Erfordert, dass nur ein Prozess mit dem ausführbaren Dateinamen ExeName übereinstimmt.

[out] Id

Empfängt die Prozess-ID des ersten Prozesses, um ExeName zu entsprechen.

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
Mehrere Prozesse stimmen mit dem Dateinamen der ausführbaren Datei in ExeName überein, und DEBUG_GET_PROC_ONLY_MATCH wurde in Flags festgelegt.
E_NOINTERFACE
Kein Prozess entspricht dem Dateinamen der ausführbaren Datei in ExeName.

Bemerkungen

Diese Methode ist nur für das Debuggen im Live-Benutzermodus verfügbar.

Weitere Informationen zum Erstellen und Anfügen an Livebenutzermodusziele finden Sie unter Live User-Mode Ziele.

Anforderungen

   
Zielplattform Desktop
Header dbgeng.h (include Dbgeng.h)

Siehe auch

AttachProcess

ConnectProcessServer

CreateProcessAndAttach2

GetRunningProcessDescription

GetRunningProcessSystemIds

IDebugClient

IDebugClient2

IDebugClient3

IDebugClient4

IDebugClient5