IDebugClient2::GetRunningProcessSystemIdByExecutableName-Methode (dbgeng.h)

Artikel
02/23/2024

Die GetRunningProcessSystemIdByExecutableName-Methode sucht nach einem Prozess mit einem angegebenen ausführbaren Dateinamen und gibt dessen 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 die Engine 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 ausführbare Name abgeglichen wird. Die folgenden Flags können vorhanden sein:

Flag	Beschreibung
DEBUG_GET_PROC_FULL_MATCH	ExeName gibt den vollständigen Pfadnamen der ausführbaren Datei an. Wenn dieses Flag nicht festgelegt ist, verwendet diese Methode bei der Suche 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, der mit ExeName übereinstimmt.

Rückgabewert

Diese Methode gibt möglicherweise auch Fehlerwerte zurück. Weitere Informationen finden Sie unter Rückgabewerte .

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
S_FALSE	Mehr als ein Prozess entsprach dem Namen der ausführbaren Datei in ExeName, und DEBUG_GET_PROC_ONLY_MATCH wurde in Flags festgelegt.
E_NOINTERFACE	Kein Prozess hat mit dem Namen der ausführbaren Datei in ExeName übereinstimmt.