Partilhar via


IDebugProgramProvider2::GetProviderProcessData

Recupera uma lista de programas em execução a partir de um processo especificado.

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âmetros

  • Flags
    [in] Uma combinação de sinalizadores da PROVIDER_FLAGS enumeração. Os sinalizadores a seguir são típicos para esta chamada:

    Sinalizador

    Descrição

    PFLAG_REMOTE_PORT

    Chamador estiver sendo executado na máquina remota.

    PFLAG_DEBUGGEE

    No momento está sendo depurado chamador (informações adicionais sobre empacotamento serão retornadas para cada nó).

    PFLAG_ATTACHED_TO_DEBUGGEE

    Foi anexado ao chamador, mas não é iniciado pelo depurador.

    PFLAG_GET_PROGRAM_NODES

    Chamador está solicitando uma lista de nós de programa a ser retornado.

  • pPort
    [in] A porta que o processo de chamada está em execução.

  • processId
    [in] Um AD_PROCESS_ID estruturar mantendo a identificação do processo que contém o programa em questão.

  • EngineFilter
    [in] Uma matriz de GUIDs para mecanismos de depuração atribuídos para depurar esse processo (isso serão usados para filtrar os programas que sejam realmente retornados com base no suporte a mecanismos fornecido; Se nenhum mecanismo forem especificado, em seguida, todos os programas serão retornados).

  • pProcess
    [out] A PROVIDER_PROCESS_DATA estrutura que é preenchida com as informações solicitadas.

Valor de retorno

Se bem-sucedida, retorna S_OK; Caso contrário, retorna um código de erro.

Comentários

Normalmente, este método é chamado por um processo para obter uma lista de programas em execução nesse processo. As informações retornadas são uma lista de IDebugProgramNode2 objetos.

Consulte também

Referência

IDebugProgramProvider2

IDebugDefaultPort2

AD_PROCESS_ID

CONST_GUID_ARRAY

PROVIDER_FLAGS

PROVIDER_PROCESS_DATA

IDebugProgramNode2