Método IVsSolutionBuildManager.QueryDebugLaunch (UInt32, Int32)

Artigo
08/03/2016

Publicado: abril de 2016

Determina se ou não o F5 chave (Iniciar depuração) deve ser habilitado.

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

Sintaxe

int QueryDebugLaunch(
    uint grfLaunch,
    out int pfCanLaunch
)

int QueryDebugLaunch(
    unsigned int grfLaunch,
    [OutAttribute] int% pfCanLaunch
)

abstract QueryDebugLaunch : 
        grfLaunch:uint32 *
        pfCanLaunch:int byref -> int

Function QueryDebugLaunch (
    grfLaunch As UInteger,
    <OutAttribute> ByRef pfCanLaunch As Integer
) As Integer

Parâmetros

grfLaunch
[in] Especifica como o depurador é iniciado.Consulte __VSDBGLAUNCHFLAGS para obter mais informações.

pfCanLaunch
[out] Ponteiro para um sinalizador que indica se ou não a operação de depuração pode ser iniciada.

Valor de retorno

Type: System.Int32

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

Comentários

COM assinatura

De vsshell.idl:

HRESULT IVsSolutionBuildManager::QueryDebugLaunch(
   [in] VSDBGLAUNCHFLAGS grfLaunch,
   [out] BOOL *pfCanLaunch
);

A solução criar faixas de Gerenciador qual projeto é o projeto de inicialização.O componente Gerenciador de depurador do ambiente não sabe diretamente o que é o projeto de inicialização, portanto, ele chama QueryDebugLaunch pedir o Gerenciador de compilação da solução ou não o F5 chave deve ser ativada para o projeto de inicialização, ou para o projeto selecionado se DBGLAUNCH_Selected está definida.

Se um usuário pressiona o F5 chave, o componente Gerenciador de depurador do ambiente chama este método novamente e DebugLaunch define pfCanLaunch para true.Configuração dos projetos de inicialização, selecionada para a configuração de solução ativa, em seguida, abre o processo de depurador apropriado durante a chamada para DebugLaunch quando o F5 tecla é pressionada.

O F5 comando faz com que o componente Gerenciador de depurador do ambiente para chamar DebugLaunch em cada projeto de inicialização para a configuração de projeto ativo (selecionado por configuração de solução ativa), ou qualquer outro pacote que intercepta esse comando.

Quando o usuário pressiona o F5 chave, o componente Gerenciador de depurador do ambiente entra no modo de depuração e chamadas DebugLaunch consultas os projetos do projetor por meio de sua implementação de DebugLaunch na configuração da projeto ativo na configuração do projeto ativo de cada um dos projetos de inicialização.Quando o ambiente estiver no modo de depuração, os projetos que está sendo depurados sabem o estado do processo, se ele estiver sendo executado ou em um ponto de interrupção.O componente Gerenciador de depurador de chamadas de ambiente QueryDebugLaunch e permite que o F5 chave com continuar quando um ponto de interrupção é alcançado no processo de depuração.

No ponto em que o ambiente sai do modo de depuração porque ele concluída ou foi cancelado pelo usuário e você está novamente no modo de design, o F5 chave estiver habilitada.

QueryDebugLaunche DebugLaunch são normalmente chamado apenas pelo componente de Gerenciador de depuração do ambiente para gerenciar o comando de início de debug no modo de design para determinar se ou não o lançamento de depuração deve ser habilitado.Se habilitada, quando o F5 tecla é pressionada o componente Gerenciador de depuração das chamadas do ambiente DebugLaunch para iniciar o processo de depuração para cada projeto na lista de projetos de inicialização.

Se não houver nenhum projeto de inicialização para a solução, o F5 chave será desativado.

Consulte também

Interface IVsSolutionBuildManager
Namespace Microsoft.VisualStudio.Shell.Interop

Retornar ao topo

Compartilhar via