IVsSolutionBuildManager2.DebugLaunch(UInt32) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Inicia o projeto de inicialização especificado pela solução como o projeto de depuração.
public:
int DebugLaunch(System::UInt32 grfLaunch);
public:
int DebugLaunch(unsigned int grfLaunch);
int DebugLaunch(unsigned int grfLaunch);
public int DebugLaunch (uint grfLaunch);
abstract member DebugLaunch : uint32 -> int
Public Function DebugLaunch (grfLaunch As UInteger) As Integer
Parâmetros
- grfLaunch
- UInt32
no Especifica os sinalizadores de inicialização. Consulte __VSDBGLAUNCHFLAGS para obter mais informações.
Retornos
Se o método for bem-sucedido, retornará S_OK. Se falhar, retornará um código de erro.
Implementações
Comentários
Assinatura COM
De VSShell. idl:
HRESULT IVsSolutionBuildManager2::DebugLaunch(
[in] VSDBGLAUNCHFLAGS grfLaunch
);
O Gerenciador de Build de solução controla o projeto de inicialização ou os projetos em que uma operação será executada quando a tecla F5 é pressionada através de entradas nas páginas de propriedades de configuração da solução. IVsSolutionBuildManager2 é chamado pelo ambiente para determinar quando a tecla F5 será habilitada. Quando o ambiente está no modo de depuração, ele desabilita a tecla F5 até que a depuração alcance um ponto de interrupção; nesse caso, a tecla F5 será habilitada com um comando continue ou quando a depuração for interrompida, nesse caso, a tecla F5 será habilitada com um comando Start.
Quando F5 é pressionado, DebugLaunch será chamado pelo componente Gerenciador de depuração do ambiente para iniciar a operação no projeto ou projetos de inicialização. Nesse ponto, o ambiente chama DebugLaunch a 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 do projeto usando informações específicas do projeto.
Observação
O depurador iniciado pode ser um mecanismo de depuração gerenciado ou nativo da Microsoft ou um depurador personalizado de seu próprio design como um desenvolvedor VSIP.
IVsSolutionBuildManager2 Sabe qual projeto ou projetos devem ser 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 sabem 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 Gerenciando opções de configuração.
Em alguns casos, talvez você queira ter um pacote diferente do início do depurador quando a tecla F5 é pressionada. Nesse caso, seu VSPackage, por meio de sua implementação de IVsSolutionBuildManager2 e DebugLaunch , determina o projeto de inicialização ou os projetos nos quais o pacote funcionará e começará a processar.