IDebugProgramProvider2::GetProviderProcessDataIDebugProgramProvider2::GetProviderProcessData

Récupère une liste de programmes en cours d’exécution à partir d’un processus spécifié.Retrieves a list of running programs from a specified process.

SyntaxeSyntax

HRESULT GetProviderProcessData(  
   PROVIDER_FLAGS         Flags,  
   IDebugDefaultPort2*    pPort,  
   AD_PROCESS_ID          processId,  
   CONST_GUID_ARRAY       EngineFilter,  
   PROVIDER_PROCESS_DATA* pProcess  
);  
int GetProviderProcessData(  
   enum_PROVIDER_FLAGS     Flags,  
   IDebugDefaultPort2      pPort,  
   AD_PROCESS_ID           ProcessId,  
   CONST_GUID_ARRAY        EngineFilter,  
   PROVIDER_PROCESS_DATA[] pProcess  
);  

ParamètresParameters

Flags
[in] Une combinaison d’indicateurs à partir de la PROVIDER_FLAGS énumération.[in] A combination of flags from the PROVIDER_FLAGS enumeration. Les indicateurs suivants sont classiques pour cet appel :The following flags are typical for this call:

IndicateurFlag DescriptionDescription
PFLAG_REMOTE_PORT L’appelant est en cours d’exécution sur l’ordinateur distant.Caller is running on remote machine.
PFLAG_DEBUGGEE L’appelant est en cours de débogage (informations supplémentaires sur le marshaling seront affichera pour chaque nœud).Caller is currently being debugged (additional information about marshalling will be returned for each node).
PFLAG_ATTACHED_TO_DEBUGGEE L’appelant a été attaché à mais pas lancé par le débogueur.Caller was attached to but not launched by the debugger.
PFLAG_GET_PROGRAM_NODES L’appelant demande une liste de nœuds de programme à retourner.Caller is asking for a list of program nodes to be returned.

pPort
[in] Le port, le processus appelant s’exécute sur.[in] The port the calling process is running on.

processId
[in] Un AD_PROCESS_ID structure qui contient l’ID du processus qui contient le programme en question.[in] An AD_PROCESS_ID structure holding the ID of the process that contains the program in question.

EngineFilter
[in] Un tableau de GUID pour les moteurs de débogage affectés pour déboguer ce processus (ils seront utilisés pour filtrer les programmes qui sont retournés en fonction de ce que les moteurs fournies prend en charge ; si aucun moteur n’est spécifiés, tous les programmes seront retourné).[in] An array of GUIDs for debug engines assigned to debug this process (these will be used to filter the programs that are actually returned based on what the supplied engines support; if no engines are specified, then all programs will be returned).

pProcess
[out] A PROVIDER_PROCESS_DATA structure est remplie avec les informations demandées.[out] A PROVIDER_PROCESS_DATA structure that is filled in with the requested information.

Valeur de retourReturn Value

En cas de réussite, retourne S_OK; sinon, retourne un code d’erreur.If successful, returns S_OK; otherwise, returns an error code.

NotesRemarks

Normalement, cette méthode est appelée par un processus pour obtenir une liste des programmes en cours d’exécution dans ce processus.This method is normally called by a process to obtain a list of programs running in that process. Les informations renvoyées sont une liste de IDebugProgramNode2 objets.The returned information is a list of IDebugProgramNode2 objects.

Voir aussiSee Also

IDebugProgramProvider2 IDebugProgramProvider2
IDebugDefaultPort2 IDebugDefaultPort2
AD_PROCESS_ID AD_PROCESS_ID
CONST_GUID_ARRAY CONST_GUID_ARRAY
PROVIDER_FLAGS PROVIDER_FLAGS
PROVIDER_PROCESS_DATA PROVIDER_PROCESS_DATA
IDebugProgramNode2IDebugProgramNode2