IDebugProgramProvider2::GetProviderProcessDataIDebugProgramProvider2::GetProviderProcessData

Recupera una lista de programas en ejecución desde un proceso especificado.Retrieves a list of running programs from a specified process.

SintaxisSyntax

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  
);  

ParámetrosParameters

Flags
[in] Una combinación de marcas de la PROVIDER_FLAGS enumeración.[in] A combination of flags from the PROVIDER_FLAGS enumeration. Las marcas siguientes son típicas para esta llamada:The following flags are typical for this call:

MarcarFlag DescripciónDescription
PFLAG_REMOTE_PORT Autor de la llamada se está ejecutando en el equipo remoto.Caller is running on remote machine.
PFLAG_DEBUGGEE Autor de la llamada se está depurando (información adicional sobre el cálculo de referencias se devolverán para cada nodo).Caller is currently being debugged (additional information about marshalling will be returned for each node).
PFLAG_ATTACHED_TO_DEBUGGEE Autor de llamada se adjunta a pero no se inicia el depurador.Caller was attached to but not launched by the debugger.
PFLAG_GET_PROGRAM_NODES Llamador está solicitando una lista de nodos del programa va a devolver.Caller is asking for a list of program nodes to be returned.

pPort
[in] El puerto que el proceso de llamada se ejecuta en.[in] The port the calling process is running on.

processId
[in] Un AD_PROCESS_ID estructura que contiene el identificador del proceso que contiene el programa en cuestión.[in] An AD_PROCESS_ID structure holding the ID of the process that contains the program in question.

EngineFilter
[in] Una matriz de GUID para los motores de depuración asignado para depurar este proceso (se utilizarán para filtrar los programas que realmente se devuelven según lo que admiten los motores proporcionados; si no hay motores se especifican, se devolverá todos los programas).[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] Un PROVIDER_PROCESS_DATA estructura que se rellena con la información solicitada.[out] A PROVIDER_PROCESS_DATA structure that is filled in with the requested information.

Valor devueltoReturn Value

Si es correcto, devuelve S_OK; en caso contrario, devuelve un código de error.If successful, returns S_OK; otherwise, returns an error code.

ComentariosRemarks

Normalmente, este método se llama mediante un proceso para obtener una lista de programas que se ejecutan en ese proceso.This method is normally called by a process to obtain a list of programs running in that process. La información devuelta es una lista de IDebugProgramNode2 objetos.The returned information is a list of IDebugProgramNode2 objects.

Vea tambiénSee 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