IDebugProgramProvider2::GetProviderProcessData
Recupera uma lista de programas em execução de um processo especificado.
Sintaxe
int GetProviderProcessData(
enum_PROVIDER_FLAGS Flags,
IDebugDefaultPort2 pPort,
AD_PROCESS_ID ProcessId,
CONST_GUID_ARRAY EngineFilter,
PROVIDER_PROCESS_DATA[] pProcess
);
Parâmetros
Flags
[em] Uma combinação de sinalizadores da enumeração PROVIDER_FLAGS . Os seguintes sinalizadores são típicos para esta chamada:
| Sinalizador | Descrição |
|---|---|
PFLAG_REMOTE_PORT |
O chamador está sendo executado na máquina remota. |
PFLAG_DEBUGGEE |
O chamador está sendo depurado no momento (informações adicionais sobre marshalling serão retornadas para cada nó). |
PFLAG_ATTACHED_TO_DEBUGGEE |
O chamador foi anexado, mas não iniciado pelo depurador. |
PFLAG_GET_PROGRAM_NODES |
O chamador está solicitando que uma lista de nós do programa seja retornada. |
pPort
[em] A porta em que o processo de chamada está sendo executado.
processId
[em] Uma estrutura AD_PROCESS_ID que contém a ID do processo que contém o programa em questão.
EngineFilter
[em] Uma matriz de GUIDs para mecanismos de depuração atribuídos para depurar esse processo (eles serão usados para filtrar os programas que são realmente retornados com base no que os mecanismos fornecidos suportam; se nenhum mecanismo for especificado, todos os programas serão retornados).
pProcess
[saiu] Uma estrutura PROVIDER_PROCESS_DATA que é preenchida com as informações solicitadas.
Valor de retorno
Se tiver êxito, retornará S_OK. Caso contrário, retornará um código de erro.
Comentários
Esse método é normalmente chamado por um processo para obter uma lista de programas em execução nesse processo. As informações retornadas são uma lista de objetos IDebugProgramNode2 .