Activación de un cliente de depuración

Una vez activado el servidor de depuración, puede iniciar un cliente de depuración en otro equipo y conectarse a la sesión de depuración.

Hay dos maneras de iniciar un cliente de depuración: mediante la opción de línea de comandos -remote o mediante la interfaz gráfica de WinDbg.

El protocolo del cliente debe coincidir con el protocolo del servidor. La sintaxis general para iniciar un cliente de depuración depende del protocolo usado. Hay las siguientes opciones:

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 la interfaz gráfica para conectarse a una sesión de depuración remota, WinDbg debe estar en modo inactivo; debe haberse iniciado sin parámetros de línea de comandos o debe haber finalizado la sesión de depuración anterior. Seleccione el archivo | Conéctese al comando de menú Sesión remota o presione la tecla de método abreviado CTRL+R. Cuando aparezca el cuadro de diálogo Conectar a sesión del depurador remoto , escriba una de las siguientes cadenas en el cuadro de texto Cadena de conexión :

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, puede usar el botón Examinar para buscar servidores de depuración activos.

Los parámetros de los comandos anteriores tienen los siguientes valores posibles:

Depurador
Esto no tiene que ser el mismo depurador que el que usa el cliente de depuración: WinDbg, KD y CDB son intercambiables para fines de depuración remota a través del depurador.

Servidor
Este es el nombre de red o la dirección IP del equipo en el que se creó el servidor de depuración. Las dos barras diagonales inversas iniciales (\) son opcionales en la línea de comandos, pero no se permiten en el cuadro de diálogo WinDbg.

pipe=PipeName
Si se usa el protocolo NPIPE o SPIPE, PipeName es el nombre que se dio a la canalización cuando se creó el servidor.

Si no ha iniciado sesión en el equipo cliente con una cuenta que tenga acceso al equipo servidor, debe proporcionar un nombre de usuario y una contraseña. En el equipo cliente, en una ventana del símbolo del sistema, escriba el siguiente comando.

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

donde Server es el nombre del equipo servidor y UserName es el nombre de una cuenta que tiene acceso al equipo servidor.

Cuando se le solicite, escriba la contraseña de UserName.

Una vez que este comando se realiza correctamente, puede activar un cliente de depuración mediante la opción de línea de comandos -remote o mediante la interfaz gráfica de WinDbg.

Nota Es posible que tenga que habilitar el uso compartido de archivos e impresoras en el equipo servidor. En Panel de control, vaya a Configuración avanzada de uso compartido de red e internet y> red de Internet>. Seleccione Activar el uso compartido de archivos e impresoras.

port=Socket
Si se usa el protocolo TCP o SSL, Socket es el mismo número de puerto de socket que se usó cuando se creó el servidor.

clicon
Especifica que el servidor de depuración intentará conectarse al cliente a través de una conexión inversa. El cliente debe usar clicon si y solo si el servidor usa clicon. En la mayoría de los casos, el cliente de depuración se inicia antes del servidor de depuración cuando se usa una conexión inversa.

port=COMPort
Si se usa el protocolo COM, COMPort especifica el puerto COM que se va a usar. El prefijo "COM" es opcional; por ejemplo, "com2" y "2" son aceptables.

baud=BaudRate
Si se usa el protocolo COM, BaudRate debe coincidir con la velocidad de baudios elegida cuando se creó el servidor.

channel=COMChannel
Si se usa el protocolo COM, COMChannel debe coincidir con el número de canal elegido cuando se creó el servidor.

proto=Protocol
Si se usa el protocolo SSL o SPIPE, el protocolo debe coincidir con el protocolo seguro usado cuando se creó el servidor.

Cert
Si se usa el protocolo SSL o SPIPE, debe usar el parámetro certuser=Cert o machuser=Cert idéntico que se usó cuando se creó el servidor.

password=Password
Si se usó una contraseña cuando se creó el servidor, se debe proporcionar la contraseña para crear el cliente de depuración. Debe coincidir con la contraseña original. En las contraseñas se distingue entre mayúsculas y minúsculas. Si se proporciona la contraseña incorrecta, el mensaje de error especificará "Error 0x80004005". Las contraseñas deben tener doce caracteres o menos longitud.

ipversion=6
(Herramientas de depuración para Windows 6.6.07 y versiones anteriores) Obliga al depurador a usar la versión 6 de IP en lugar de la versión 4 cuando se usa TCP para conectarse a Internet. En Windows Vista y versiones posteriores, el depurador intenta establecer automáticamente el valor predeterminado en la versión 6 de IP, lo que hace que esta opción no sea necesaria.

El cliente de depuración no puede usar las opciones de línea de comandos usadas para iniciar nuevas sesiones de depuración (como -p), sino solo para el servidor. Las opciones de configuración (como -n) funcionarán desde el cliente o el servidor.