IDebugProgramProvider2::GetProviderProcessDataIDebugProgramProvider2::GetProviderProcessData

Recupera uma lista de programas em execução de um processo especificado.Retrieves a list of running programs from a specified process.

SintaxeSyntax

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] Uma combinação de sinalizadores do PROVIDER_FLAGS enumeração.[in] A combination of flags from the PROVIDER_FLAGS enumeration. Os sinalizadores a seguir são típicos para essa chamada:The following flags are typical for this call:

SinalizadorFlag DescriçãoDescription
PFLAG_REMOTE_PORT Chamador está em execução no computador remoto.Caller is running on remote machine.
PFLAG_DEBUGGEE Chamador está atualmente em depuração (informações adicionais sobre a realização de marshaling serão retornadas para cada nó).Caller is currently being debugged (additional information about marshalling will be returned for each node).
PFLAG_ATTACHED_TO_DEBUGGEE Chamador foi anexado ao, mas não é iniciado pelo depurador.Caller was attached to but not launched by the debugger.
PFLAG_GET_PROGRAM_NODES Chamador está pedindo para obter uma lista de nós de programa a ser retornado.Caller is asking for a list of program nodes to be returned.

pPort
[in] A porta que o processo de chamada está em execução.[in] The port the calling process is running on.

processId
[in] Uma AD_PROCESS_ID estrutura que contém a ID do processo que contém o programa em questão.[in] An AD_PROCESS_ID structure holding the ID of the process that contains the program in question.

EngineFilter
[in] Uma matriz de GUIDs para os mecanismos de depuração atribuídos para depurar esse processo (eles serão usados para filtrar os programas que são retornados, na verdade, com base no que o suportam os mecanismos fornecidos; se não há mecanismos forem especificados, em seguida, serão retornados todos os 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] Um PROVIDER_PROCESS_DATA estrutura será preenchida com as informações solicitadas.[out] A PROVIDER_PROCESS_DATA structure that is filled in with the requested information.

Valor de retornoReturn Value

Se for bem-sucedido, retornará S_OK; caso contrário, retorna um código de erro.If successful, returns S_OK; otherwise, returns an error code.

ComentáriosRemarks

Normalmente, esse método é chamado por um processo para obter uma lista de programas em execução nesse processo.This method is normally called by a process to obtain a list of programs running in that process. As informações retornadas são uma lista dos IDebugProgramNode2 objetos.The returned information is a list of IDebugProgramNode2 objects.

Consulte tambémSee also