Ativando um cliente de depuração

Depois que o servidor de depuração for ativado, você poderá iniciar um cliente de depuração em outro computador e conectar-se à sessão de depuração.

Há duas maneiras de iniciar um cliente de depuração: usando a opção de linha de comando -remote ou usando a interface gráfica WinDbg.

O protocolo do cliente deve corresponder ao protocolo do servidor. A sintaxe geral para iniciar um cliente de depuração depende do protocolo usado. Existem as seguintes opções:

Debugger -remote npipe:server=Server,pipe=PipeName[,password=Password] 

Debugger -remote tcp:server=Server,port=Socket[,password=Password][,ipversion=6] 

Debugger -remote tcp:clicon=Server,port=Socket[,password=Password][,ipversion=6] 

Debugger -remote com:port=COMPort,baud=BaudRate,channel=COMChannel[,password=Password] 

Debugger -remote spipe:proto=Protocol,{certuser=Cert|machuser=Cert},server=Server,pipe=PipeName[,password=Password] 

Debugger -remote ssl:proto=Protocol,{certuser=Cert|machuser=Cert},server=Server,port=Socket[,password=Password] 

Debugger -remote ssl:proto=Protocol,{certuser=Cert|machuser=Cert},clicon=Server,port=Socket[,password=Password] 

Para usar a interface gráfica para se conectar a uma sessão de depuração remota, o WinDbg deve estar no modo inativo . Ele deve ter sido iniciado sem parâmetros de linha de comando ou deve ter terminado a sessão de depuração anterior. Selecione o Arquivo | Conecte-se ao comando de menu Sessão Remota ou pressione a tecla de atalho CTRL+R. Quando a caixa de diálogo Conectar-se à Sessão do Depurador Remoto for exibida, insira uma das seguintes cadeias de caracteres na caixa de texto Cadeia de conexão :

npipe:server=Server,pipe=PipeName[,password=Password] 

tcp:server=Server,port=Socket[,password=Password][,ipversion=6] 

tcp:clicon=Server,port=Socket[,password=Password][,ipversion=6] 

com:port=COMPort,baud=BaudRate,channel=COMChannel[,password=Password] 

spipe:proto=Protocol,{certuser=Cert|machuser=Cert},server=Server,pipe=PipeName[,password=Password] 

ssl:proto=Protocol,{certuser=Cert|machuser=Cert},server=Server,port=Socket[,password=Password] 

ssl:proto=Protocol,{certuser=Cert|machuser=Cert},clicon=Server,port=Socket[,password=Password] 

Como alternativa, você pode usar o botão Procurar para localizar servidores ativos de depuração.

Os parâmetros nos comandos anteriores têm os seguintes valores possíveis:

Depurador
Isso não precisa ser o mesmo depurador usado pelo cliente de depuração – WinDbg, KD e CDB são intercambiáveis para fins de depuração remota por meio do depurador.

Servidor
Esse é o nome de rede ou endereço IP do computador no qual o servidor de depuração foi criado. As duas barras iniciais (\) são opcionais na linha de comando, mas não são permitidas na caixa de diálogo WinDbg.

pipe=PipeName
Se o protocolo NPIPE ou SPIPE for usado, PipeName será o nome que foi dado ao pipe quando o servidor foi criado.

Se você não estiver conectado ao computador cliente com uma conta que tenha acesso ao computador servidor, deverá fornecer um nome de usuário e uma senha. No computador cliente, em uma janela do Prompt de Comando, insira o comando a seguir.

net use \\Server\ipc$ /user:UserName

em que Server é o nome do computador servidor e UserName é o nome de uma conta que tem acesso ao computador servidor.

Quando for solicitado, insira a senha para UserName.

Depois que esse comando for bem-sucedido, você poderá ativar um cliente de depuração usando a opção -remote command-line ou usando a interface gráfica WinDbg.

Nota Talvez seja necessário habilitar o compartilhamento de arquivos e impressoras no computador do servidor. Em Painel de Controle, navegue até Rede e Rede da Internet > e Configurações avançadas de compartilhamento do Centro> de Compartilhamento. Selecione Ativar o compartilhamento de arquivos e impressoras.

port=Socket
Se o protocolo TCP ou SSL for usado, Socket será o mesmo número de porta de soquete usado quando o servidor foi criado.

clicon
Especifica que o servidor de depuração tentará se conectar ao cliente por meio de uma conexão inversa. O cliente deverá usar clicon se e somente se o servidor estiver usando a clicon. Na maioria dos casos, o cliente de depuração é iniciado antes do servidor de depuração quando uma conexão inversa é usada.

port=COMPort
Se o protocolo COM for usado, COMPort especificará a porta COM a ser usada. O prefixo "COM" é opcional , por exemplo, "com2" e "2" são aceitáveis.

baud=BaudRate
Se o protocolo COM for usado, BaudRate deverá corresponder à taxa de baud escolhida quando o servidor foi criado.

channel=COMChannel
Se o protocolo COM for usado, COMChannel deverá corresponder ao número de canal escolhido quando o servidor foi criado.

proto=Protocol
Se o protocolo SSL ou SPIPE for usado, Protocol deverá corresponder ao protocolo seguro usado quando o servidor foi criado.

Cert
Se o protocolo SSL ou SPIPE for usado, você deverá usar o parâmetro idêntico certuser=Cert ou machuser=Cert usado quando o servidor foi criado.

password=Password
Se uma senha foi usada quando o servidor foi criado, a senha deve ser fornecida para criar o cliente de depuração. Ele deve corresponder à senha original. As senhas diferenciam maiúsculas de minúsculas. Se a senha errada for fornecida, a mensagem de erro especificará "Erro 0x80004005". As senhas devem ter doze caracteres ou menos de comprimento.

ipversion=6
(Ferramentas de depuração para Windows 6.6.07 e somente anteriores) Força o depurador a usar o IP versão 6 em vez da versão 4 ao usar o TCP para se conectar à Internet. No Windows Vista e versões posteriores, o depurador tenta fazer o padrão automático para o IP versão 6, tornando essa opção desnecessária.

As opções de linha de comando usadas para iniciar novas sessões de depuração (como -p) não podem ser usadas pelo cliente de depuração, mas apenas pelo servidor. As opções de configuração (como -n) funcionarão do cliente ou do servidor.