IDebugClient5 ::GetRunningProcessSystemIdByExecutableName, méthode (dbgeng.h)

Article
02/06/2025

La méthode GetRunningProcessSystemIdByExecutableName recherche un processus avec un nom de fichier exécutable donné et retourne son ID de processus.

Syntaxe

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

Paramètres

[in] Server

Spécifie le serveur de processus à rechercher le nom exécutable. Si serveur est égal à zéro, le moteur recherche le nom exécutable parmi les processus en cours d’exécution sur l’ordinateur local.

[in] ExeName

Spécifie le nom du fichier exécutable pour lequel effectuer une recherche.

[in] Flags

Spécifie un jeu de bits qui contrôle la mise en correspondance du nom exécutable. Les indicateurs suivants peuvent être présents :

Drapeau	Description
DEBUG_GET_PROC_FULL_MATCH	ExeName spécifie le nom complet du chemin d’accès du nom de fichier exécutable. Si cet indicateur n’est pas défini, cette méthode n’utilise pas de noms de chemin d’accès lors de la recherche du processus.
DEBUG_GET_PROC_ONLY_MATCH	Exiger qu’un seul processus corresponde au nom de fichier exécutable ExeName.

[out] Id

Reçoit l’ID de processus du premier processus pour qu’il corresponde à ExeName.

Valeur de retour

Cette méthode peut également retourner des valeurs d’erreur. Pour plus d’informations, consultez valeurs de retour.

Retourner le code	Description
S_OK	La méthode a réussi.
S_FALSE	Plusieurs processus correspondent au nom du fichier exécutable dans ExeName et DEBUG_GET_PROC_ONLY_MATCH a été défini dans indicateurs.
E_NOINTERFACE	Aucun processus n’a mis en correspondance le nom du fichier exécutable dans ExeName.