Método IVsSolutionBuildManager2.DebugLaunch (UInt32)

Artigo
01/24/2017

Publicado: agosto de 2016

Inicia o projeto de inicialização especificado pela solução como o projeto de depuração.

Namespace: Microsoft.VisualStudio.Shell.Interop
Assembly: Microsoft.VisualStudio.Shell.Interop (em Microsoft.VisualStudio.Shell.Interop.dll)

Sintaxe

int DebugLaunch(
    uint grfLaunch
)

int DebugLaunch(
    unsigned int grfLaunch
)

abstract DebugLaunch : 
        grfLaunch:uint32 -> int

Function DebugLaunch (
    grfLaunch As UInteger
) As Integer

Parâmetros

grfLaunch
Type: System.UInt32

[in] Especifica os sinalizadores de inicialização. Consulte __VSDBGLAUNCHFLAGS para obter mais informações.

Valor Retornado

Type: System.Int32

Se o método for bem-sucedido, ele retornará S_OK. Se ele falhar, ele retorna um código de erro.

Implementa

IVsSolutionBuildManager.DebugLaunch(UInt32)

Comentários

COM assinatura

De vsshell.idl:

HRESULT IVsSolutionBuildManager2::DebugLaunch(
   [in] VSDBGLAUNCHFLAGS grfLaunch
);

A solução de compilação manager rastreia o projeto de inicialização ou projetos que uma operação será executada em relação a quando o F5 tecla for pressionada por meio de entradas nas páginas de propriedades de configuração da solução.IVsSolutionBuildManager2 é chamado pelo ambiente para determinar quando o F5 chave será habilitada. Quando o ambiente está no modo de depuração, ele desabilita a F5 chave até depuração atinge um ponto de interrupção, caso em que o F5 chave será habilitada com um comando de continuar, ou quando a depuração parar, caso em que o F5 chave será habilitada com um comando Start.

Quando F5 é pressionado, DebugLaunch será chamado pelo componente de Gerenciador de depuração do ambiente para começar a operação no projeto de inicialização ou projetos. Nesse ponto, o ambiente chama DebugLaunch na configuração do projeto ativo de cada um dos projetos de inicialização, que inicia uma sessão de depuração no destino de configuração de projeto usando as informações específicas do projeto.

Observação
O depurador iniciado pode ser um mecanismo de depuração gerenciada ou nativa da Microsoft ou de um depurador personalizado de seu próprio projeto como um desenvolvedor do VSIP.

IVsSolutionBuildManager2 sabe qual projeto ou projetos a serem incluídos no processo de compilação com base nas configurações nas páginas de propriedades de configuração da solução e os projetos individuais saibam o que precisa ser executado quando o DebugLaunch é chamado com base nas definições de configuração conforme exibido nas páginas de propriedades de configuração do projeto. Para obter mais informações, consulte Opções de configuração de gerenciamento de.

Em alguns casos, você talvez queira ter um pacote que não seja o depurador a iniciar quando o F5 tecla é pressionada. Nesse caso, o VSPackage, pela sua implementação de IVsSolutionBuildManager2 e DebugLaunch, determina o projeto de inicialização ou projetos com o qual o pacote de operar e iniciar o processamento.

Confira Também

Interface IVsSolutionBuildManager2
Namespace Microsoft.VisualStudio.Shell.Interop

Retornar ao início

Compartilhar via