Método IVsSolutionBuildManager.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.

Comentários

COM assinatura

De vsshell.idl:

HRESULT IVsSolutionBuildManager::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 é pressionada através de entradas no configuração da solução páginas de propriedades.IVsSolutionBuildManager é 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 continuar comando, ou quando a depuração parar, caso em que o F5 chave será habilitada com um Iniciar comando.

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 IVsDebuggableProjectCfg:: 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.

IVsSolutionBuildManager 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 no configuração do projeto páginas de propriedades. 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 IVsSolutionBuildManager 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 IVsSolutionBuildManager
Namespace Microsoft.VisualStudio.Shell.Interop

Retornar ao início

Partilhar via