Partager via


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

La méthode GetRunningProcessDescriptionWide retourne une description du processus qui inclut le nom de l’image exécutable, les noms de service, les noms de package MTS et la ligne de commande.

Syntaxe

HRESULT GetRunningProcessDescriptionWide(
  [in]            ULONG64 Server,
  [in]            ULONG   SystemId,
  [in]            ULONG   Flags,
  [out, optional] PWSTR   ExeName,
  [in]            ULONG   ExeNameSize,
  [out, optional] PULONG  ActualExeNameSize,
  [out, optional] PWSTR   Description,
  [in]            ULONG   DescriptionSize,
  [out, optional] PULONG  ActualDescriptionSize
);

Paramètres

[in] Server

Spécifie le serveur de processus à interroger pour obtenir la description du processus. Si Server est égal à zéro, le moteur interroge directement les informations sur le processus local.

[in] SystemId

Spécifie l’ID de processus du processus dont la description est souhaitée.

[in] Flags

Spécifie un jeu de bits contenant des options qui affectent le comportement de cette méthode. indicateurs peuvent contenir les indicateurs de bits suivants :

Drapeau Description
DEBUG_PROC_DESC_NO_PATHS Retourne uniquement les noms de fichiers sans noms de chemin d’accès.
DEBUG_PROC_DESC_NO_SERVICES Ne recherchez pas de noms de service.
DEBUG_PROC_DESC_NO_MTS_PACKAGES Ne recherchez pas de noms de package MTS.
DEBUG_PROC_DESC_NO_COMMAND_LINE Ne récupérez pas la ligne de commande.

[out, optional] ExeName

Reçoit le nom du fichier exécutable utilisé pour démarrer le processus. Si exeName est NULL, ces informations ne sont pas retournées.

[in] ExeNameSize

Spécifie la taille en caractères de la mémoire tampon ExeNameSize. Cette taille inclut l’espace du caractère de fin « \0 ».

[out, optional] ActualExeNameSize

Reçoit la taille en caractères du nom du fichier exécutable. Cette taille inclut l’espace du caractère de fin « \0 ». Si exeNameSize est NULL, ces informations ne sont pas retournées.

[out, optional] Description

Reçoit des informations supplémentaires sur le processus, notamment les noms de service, les noms de package MTS et la ligne de commande. Si Description est NULL, ces informations ne sont pas retournées.

[in] DescriptionSize

Spécifie la taille en caractères de la mémoire tampon Description. Cette taille inclut l’espace du caractère de fin « \0 ».

[out, optional] ActualDescriptionSize

Reçoit la taille en caractères des informations supplémentaires. Cette taille inclut l’espace du caractère de fin « \0 ». Si ActualDescriptionSize est NULL, ces informations ne sont pas retournées.

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
La méthode a réussi. Toutefois, ExeNameSize ou DescriptionSize étaient inférieures à la taille de la chaîne respective et la chaîne a été tronquée pour s’adapter à la mémoire tampon.

Remarques

Cette méthode est disponible uniquement pour le débogage en mode utilisateur en direct.

Pour plus d’informations sur la création et l’attachement à des cibles en mode utilisateur en direct, consultez Cibles live User-Mode.

Exigences

Exigence Valeur
plateforme cible Bureau
d’en-tête dbgeng.h (include Dbgeng.h)

Voir aussi

AttachProcess

ConnectProcessServer

CreateProcessAndAttach2

GetRunningProcessSystemIdByExecutableName

GetRunningProcessSystemIds

IDebugClient3

IDebugClient4

IDebugClient5