Méthode IDebugClient4 ::GetRunningProcessIdByExecutableNameWide (dbgeng.h)

Article
02/26/2024

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

Syntaxe

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

Paramètres

[in] Server

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

[in] ExeName

Spécifie le nom de fichier exécutable pour lequel effectuer la recherche.

[in] Flags

Spécifie un jeu de bits qui contrôle la correspondance du nom exécutable. 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 correspondant à 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 correspondaient au nom du 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 du fichier exécutable dans ExeName.