Méthode IDebugClient3 ::GetRunningProcessSystemIdByExecutableName (dbgeng.h)

Article
02/26/2024

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 de l’exécutable. Si Server 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 de fichier exécutable à rechercher.

[in] Flags

Spécifie un jeu de bits qui contrôle la façon dont le nom exécutable est mis en correspondance. Les indicateurs suivants peuvent être présents :

Indicateur	Description
DEBUG_GET_PROC_FULL_MATCH	ExeName spécifie le nom de chemin d’accès complet du nom du 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	Exigez qu’un seul processus corresponde au nom de fichier exécutable ExeName.

[out] Id

Reçoit l’ID de processus du premier processus pour correspondre à ExeName.

Valeur retournée

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

Code de retour	Description
S_OK	La méthode a réussi.
S_FALSE	Plusieurs processus correspondent au nom de fichier exécutable dans ExeName et DEBUG_GET_PROC_ONLY_MATCH a été défini dans Indicateurs.
E_NOINTERFACE	Aucun processus ne correspondait au nom de fichier exécutable dans ExeName.