IDebugClient::GetRunningProcessSystemIdByExecutableName-Methode (dbgeng.h)

Artikel
02/06/2025

Die GetRunningProcessSystemIdByExecutableName Methode sucht nach einem Prozess mit einem bestimmten Dateinamen der ausführbaren Datei 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 namen der ausführbaren Datei gesucht werden soll. Wenn Server null ist, sucht das Modul unter den prozessen, die auf dem lokalen Computer ausgeführt werden, nach dem ausführbaren Namen.

[in] ExeName

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

[in] Flags

Gibt einen Bitsatz an, der steuert, wie der ausführbare Name übereinstimmen soll. Die folgenden Flags können vorhanden sein:

Flagge	Beschreibung
DEBUG_GET_PROC_FULL_MATCH	ExeName gibt den vollständigen Pfadnamen des Dateinamens der ausführbaren Datei an. Wenn dieses Flag 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 Dateinamen der ausführbaren Datei ExeNameübereinstimmt.

[out] Id

Empfängt die Prozess-ID des ersten Prozesses, die mit ExeNameübereinstimmen soll.

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 entsprechen dem Dateinamen der ausführbaren Datei in ExeName-und DEBUG_GET_PROC_ONLY_MATCH wurde in Flagsfestgelegt.
E_NOINTERFACE	Kein Prozess entspricht dem Dateinamen der ausführbaren Datei in ExeName.