.endrv (конечный сервер отладки)

Статья
07/08/2024

Команда .endsrv приводит к отмене активного сервера отладки отладчиком.

.endsrv ServerID

Параметры

ServerID
Указывает идентификатор сервера отладки.

Среда

Эту команду можно использовать только при выполнении удаленной отладки через отладчик.

Позиция	Description
Режимы	Только в пользовательском режиме
Целевые объекты	Динамический, аварийный дампа
Платформы	Все

Дополнительная информация

Дополнительные сведения об удаленной отладке см. в разделе "Удаленная отладка через отладчик".

Замечания

Необходимо выполнить команду .endsrv с сервера отладки или одного из клиентов отладки, подключенных к серверу отладки.

Чтобы определить идентификатор сервера отладки, используйте команду .servers (List Debugging Servers).

Команда .endsrv может завершить отладчик сервера, но не может завершить сервер обработки или сервер подключения KD. Сведения о том, как завершить эти серверы, см. в разделе "Управление сеансом сервера обработки и управление сеансом сервера подключения KD". (Однако существует один исключительный случай, когда .endrv может завершить сервер обработки, запущенный программным способом; дополнительные сведения см. в разделе IDebugClient::StartProcessServer.)

Если отменить отладку сервера, вы не допустите подключение будущих клиентов отладки к серверу. Однако при отмене отладчика сервера вы не отсоединяете клиенты, которые в настоящее время подключены через сервер.

Рассмотрим следующую ситуацию. Предположим, что вы запускаете некоторые серверы отладки, как показано в следующем примере.

0:000> .server npipe:pipe=rabbit
Server started with 'npipe:pipe=rabbit'
0:000> .server tcp:port=7
Server started with 'tcp:port=7'

Затем вы решили использовать пароль, как показано в следующем примере.

0:000> .server npipe:pipe=tiger,password=hardtoguess
Server started with 'npipe:pipe=tiger,password=hardtoguess'

Но предыдущие серверы по-прежнему работают, поэтому их следует отменить, как показано в следующем примере.

0:000> .servers
0 - Debugger Server - npipe:Pipe=rabbit
1 - Debugger Server - tcp:Port=7
2 - Debugger Server - npipe:Pipe=tiger,Password=*
0:000> .endsrv 0
Server told to exit.  Actual exit may be delayed until
the next connection attempt.
0:000> .endsrv 1
Server told to exit.  Actual exit may be delayed until
the next connection attempt.
0:000> .servers
0 - <Disabled, exit pending>
1 - <Disabled, exit pending>
2 - Debugger Server - npipe:Pipe=tiger,Password=*

Наконец, чтобы убедиться, что ничего не подключено к компьютеру, пока предыдущие серверы были активными, используйте команду .client (List Debugging Clients).

0:000> .clients
HotMachine\HostUser, last active Mon Mar 04 16:05:21 2002

Внимание, что использование пароля с протоколом TCP, NPIPE или COM обеспечивает только небольшое количество защиты, так как пароль не шифруется. При использовании пароля вместе с протоколом SSL или SPIPE пароль шифруется. Если вы хотите установить безопасный удаленный сеанс, необходимо использовать протокол SSL или SPIPE.

Поделиться через