IDebugProgramNode2::Attach_V7

  • Artigo

Observação

PRETERIDO. NÃO USE.

Sintaxe

int Attach_V7 (
   IDebugProgram2       pMDMProgram,
   IDebugEventCallback2 pCallback,
   uint                 dwReason
);

Parâmetros

pMDMProgram
[em] A interface IDebugProgram2 que representa o programa ao qual anexar.

pCallback
[em] A interface IDebugEventCallback2 a ser usada para enviar eventos de depuração para o SDM.

dwReason
[em] Um valor da enumeração ATTACH_REASON que especifica o motivo da anexação.

Valor de retorno

Uma implementação deve sempre retornar E_NOTIMPL.

Comentários

Aviso

A partir do Visual Studio 2005, esse método não é mais usado e sempre deve retornar E_NOTIMPL. Consulte a interface IDebugProgramNodeAttach2 para obter uma abordagem alternativa se o nó do programa precisar indicar que não pode ser anexado ou se o nó do programa estiver simplesmente definindo o programa GUID. Caso contrário, implemente o método Attach .

Antes do Visual Studio 2005

Esse método precisa ser implementado somente se o DE for executado no espaço de endereço do programa que está sendo depurado. Caso contrário, esse método deve retornar S_FALSE.

Quando esse método é chamado, o DE deve enviar o objeto de evento IDebugEngineCreateEvent2, se ele ainda não tiver sido enviado para esta instância da interface IDebugEngine2, bem como os objetos de evento IDebugProgramCreateEvent2 e IDebugLoadCompleteEvent2. O objeto de evento IDebugEntryPointEvent2 será enviado se o dwReason parâmetro for ATTACH_REASON_LAUNCH.

O DE deve chamar o método GetProgramId no objeto IDebugProgram2 fornecido pelo objeto de evento IDebugProgramCreateEvent2 e deve armazenar o GUID desse programa nos dados da instância para o IDebugProgram2 objeto implementado pelo DE.

Confira também