IDebugClient3::GetRunningProcessSystemIdByExecutableName-Methode (dbgeng.h)

Artikel
02/26/2024

Die GetRunningProcessSystemIdByExecutableName-Methode sucht nach einem Prozess mit einem angegebenen 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, auf dem 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 namen der ausführbaren Datei.

[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 name der ausführbaren Datei übereinstimmt. Möglicherweise sind die folgenden Flags vorhanden:

Flag	Beschreibung
DEBUG_GET_PROC_FULL_MATCH	ExeName gibt den vollständigen Pfadnamen des ausführbaren Dateinamens an. Wenn dieses Flag nicht festgelegt ist, verwendet diese Methode bei der Suche nach dem Prozess keine Pfadnamen.
DEBUG_GET_PROC_ONLY_MATCH	Erfordern Sie, dass nur ein Prozess mit dem ausführbaren Dateinamen ExeName übereinstimmt.

[out] Id

Empfängt die Prozess-ID des ersten Prozesses, der mit ExeName übereinstimmt.

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 entsprachen dem Namen der ausführbaren Datei in ExeName, und DEBUG_GET_PROC_ONLY_MATCH wurde in Flags festgelegt.
E_NOINTERFACE	Kein Prozess entsprach dem Namen der ausführbaren Datei in ExeName.