Condividi tramite


.endsrv (server di debug finale)

Il comando .endsrv fa sì che il debugger annulla un server di debug attivo.

.endsrv ServerID 

Parametri

ServerID
Specifica l'ID del server di debug.

Ambiente

È possibile usare questo comando solo quando si esegue il debug remoto tramite il debugger.

Articolo Descrizione
Modalità Solo modalità utente
Obiettivi Live, crash dump
Piattaforme Tutto

Informazioni aggiuntive

Per altre informazioni sul debug remoto, vedere debug remoto tramite il debugger.

Importante

Quando si usa il debug remoto, è necessario tenere presenti importanti considerazioni sulla sicurezza. Per altre informazioni, incluse le informazioni sull'abilitazione della modalità protetta, vedere Considerazioni sulla sicurezza per gli strumenti di debug di Windows.

Osservazioni

È necessario eseguire il comando .endsrv dal server di debug o da uno dei client di debug connessi al server di debug.

Per determinare l'ID di un server di debug, usare il comando .servers (Elenca server di debug).

Il comando .endsrv può terminare un server di debug, ma non può terminare un server di elaborazione o un server di connessione KD. Per informazioni su come terminare questi server, vedere Controllo di una sessione del server di elaborazione e controllo di una sessione del server di connessione KD. Esiste tuttavia un caso eccezionale quando .endsrv può terminare un server di elaborazione avviato a livello di codice. Per informazioni dettagliate, vedere IDebugClient::StartProcessServer.

Se si annulla un server di debug, si impedisce ai client di debug futuri di connettersi al server. Tuttavia, se si annulla un server di debug, non si scollegano i client attualmente collegati tramite il server.

Si consideri la situazione seguente. Si supponga di avviare alcuni server di debug, come illustrato nell'esempio seguente.

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

Si decide quindi di usare una password, come illustrato nell'esempio seguente.

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

Ma i server precedenti sono ancora in esecuzione, quindi è consigliabile annullarli, come illustrato nell'esempio seguente.

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=*

Infine, per assicurarsi che nessun elemento collegato al computer mentre i server precedenti erano attivi, usare il comando .clients (Elenca client di debug).

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

Importante

L'uso di una password con protocollo TCP, NPIPE o COM offre solo una piccola quantità di protezione, perché la password non è crittografata. Quando si usa una password insieme a un protocollo SSL o SPIPE, la password viene crittografata. Se si vuole stabilire una sessione remota sicura, è necessario usare il protocollo SSL o SPIPE.