Een slimme client activeren
Zodra de server van het DbgSrv-proces is geactiveerd, kunt u een slimme client op een andere computer maken en een foutopsporingssessie starten.
Er zijn twee manieren om een slimme client te starten: door CDB of WinDbg te starten met de -premote opdrachtregeloptieof met behulp van de grafische WinDbg-interface.
Belangrijk
Er zijn belangrijke beveiligingsoverwegingen bij het gebruik van externe foutopsporing. Zie Security During Remote Debugging and Security Considerations for Windows Debugging Toolsvoor meer informatie, waaronder informatie over het inschakelen van de beveiligde modus.
Het protocol van de slimme client moet overeenkomen met het protocol van de processerver. De algemene syntaxis voor het starten van een slimme client is afhankelijk van het gebruikte protocol. De volgende opties zijn beschikbaar:
Aanbevolen verbindingsmethoden, met extra beveiliging
Debugger -premote spipe:proto=Protocol,{certuser=Cert|machuser=Cert},server=Server,pipe=PipeName[,password=Password] [Options]
Debugger -premote ssl:proto=Protocol,{certuser=Cert|machuser=Cert},server=Server,port=Socket[,password=Password] [Options]
Debugger -premote ssl:proto=Protocol,{certuser=Cert|machuser=Cert},clicon=Server,port=Socket[,password=Password] [Options]
Debugger -premote com:port=COMPort,baud=BaudRate,channel=COMChannel[,password=Password] [Options]
niet-beveiligde verbindingsmethoden
Debugger -premote npipe:server=Server,pipe=PipeName[,password=Password] [Options]
Debugger -premote tcp:server=Server,port=Socket[,password=Password][,ipversion=6] [Options]
Debugger -premote tcp:clicon=Server,port=Socket[,password=Password][,ipversion=6] [Options]
Als u de grafische interface wilt gebruiken om verbinding te maken met een processerver, moet WinDbg zich in de slaapstand bevinden. Deze moet zijn gestart zonder opdrachtregelparameters of de vorige foutopsporingssessie zijn beëindigd. Selecteer het -bestand | Verbinding maken met remote Stub menuopdracht. Wanneer het dialoogvenster Verbinding maken met externe Stub-server wordt weergegeven, voert u een van de volgende tekenreeksen in het tekstvak verbindingsreeks in:
Aanbevolen verbindingsmethoden, met extra beveiliging
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]
com:port=COMPort,baud=BaudRate,channel=COMChannel[,password=Password]
niet-beveiligde verbindingsmethoden
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]
U kunt ook de knop Bladeren gebruiken om actieve processervers te zoeken.
Parameters
De parameters in de voorgaande opdrachten hebben de volgende mogelijke waarden:
foutopsporingsprogramma
Dit kan CDB of WinDbg zijn.
Server
Dit is de netwerknaam of het IP-adres van de computer waarop de processerver is gemaakt. De twee eerste backslashes (\) zijn optioneel op de opdrachtregel, maar zijn niet toegestaan in het dialoogvenster WinDbg.
pipe=PipeName
Als het NPIPE- of SPIPE-protocol wordt gebruikt, is PipeName de naam die aan de pijp is gegeven toen de processerver werd gemaakt.
Als u niet bent aangemeld bij de clientcomputer met een account dat toegang heeft tot de servercomputer, moet u een gebruikersnaam en wachtwoord opgeven. Voer op de clientcomputer in een opdrachtpromptvenster de volgende opdracht in.
net use \\Server\ipc$ /user:UserName
waarbij Server de naam van de servercomputer is en Gebruikersnaam de naam is van een account dat toegang heeft tot de servercomputer.
Wanneer u hierom wordt gevraagd, voert u het wachtwoord in voor gebruikersnaam.
Nadat deze opdracht is geslaagd, kunt u een slimme client activeren met behulp van de -premote opdrachtregeloptie of met behulp van de grafische WinDbg-interface.
Opmerking Mogelijk moet u het delen van bestanden en printers op de servercomputer inschakelen. Navigeer in het Configuratiescherm naar Netwerk- en Internet > Network and Sharing Center> Geavanceerde instellingen voor delen. Selecteer Bestands- en printerdeling inschakelen.
poort=Socket-
Als TCP- of SSL-protocol wordt gebruikt, is Socket hetzelfde poortnummer dat is gebruikt toen de processerver werd gemaakt.
clicon
Hiermee geeft u op dat de processerver probeert verbinding te maken met de slimme client via een omgekeerde verbinding. De client moet clicon gebruiken als en alleen als de server clicongebruikt. In de meeste gevallen wordt de slimme client gestart vóór de processerver wanneer een omgekeerde verbinding wordt gebruikt.
-poort=COMPort-
Als het COM-protocol wordt gebruikt, geeft COMPort- de COM-poort op die moet worden gebruikt. Het voorvoegsel 'COM' is optioneel, bijvoorbeeld zowel 'com2' als '2'.
baud=BaudRate
Als het COM-protocol wordt gebruikt, moet BaudRate overeenkomen met de baudrate die is gekozen toen de processerver werd gemaakt.
channel=COMChannel-
Als HET COM-protocol wordt gebruikt, moet COMChannel- overeenkomen met het kanaalnummer dat is gekozen toen de processerver werd gemaakt.
proto=Protocol
Als het SSL- of SPIPE-protocol wordt gebruikt, moet Protocol overeenkomen met het beveiligde protocol dat wordt gebruikt toen de processerver werd gemaakt.
certificaat
Als het SSL- of SPIPE-protocol wordt gebruikt, moet u de identieke certuser=Cert of sqlser=parameter Cert gebruiken die is gebruikt toen de processerver werd gemaakt.
wachtwoord=Wachtwoord
Als er een wachtwoord is gebruikt toen de processerver werd gemaakt, moet Wachtwoord worden opgegeven om de slimme client te kunnen maken. Deze moet overeenkomen met het oorspronkelijke wachtwoord. Wachtwoorden zijn hoofdlettergevoelig. Als het verkeerde wachtwoord is opgegeven, geeft het foutbericht 'Fout 0x80004005' op.
ipversion=6
(Alleen hulpprogramma's voor foutopsporing voor Windows 6.6.07 en eerder) Dwingt het foutopsporingsprogramma om IP-versie 6 te gebruiken in plaats van versie 4 wanneer u TCP gebruikt om verbinding te maken met internet. In Windows Vista en latere versies probeert het foutopsporingsprogramma automatisch standaard ip-versie 6 te gebruiken, waardoor deze optie niet nodig is.
Opties
Eventuele extra opdrachtregelparameters kunnen hier worden geplaatst. Zie Command-Line Opties voor een volledige lijst. Als u CDB gebruikt, moet dit het proces opgeven dat u wilt opsporen. Als u WinDbg gebruikt, kunt u het proces op de opdrachtregel of via de grafische interface opgeven.
Omdat de processerver gewoon fungeert als een gateway voor de slimme client, zijn de extra Opties hetzelfde zijn als die u zou gebruiken als u een foutopsporingsprogramma in de gebruikersmodus op dezelfde computer start als de doeltoepassing.
Als u de optie -premote gebruikt met .attach (koppelen aan proces) of .create (Proces maken), zijn de parameters hetzelfde als de parameters die hierboven worden vermeld.
Probleemoplossing
Als u dit bericht ziet: De client gebruikt niet dezelfde versie van het externe protocol als de server dit geeft aan dat de versie van DbgSrv waarmee u verbinding probeert te maken een andere protocolversie gebruikt dan de versie van WinDbg.
Het is ongebruikelijk dat protocolwijzigingen worden aangebracht. Wanneer dit gebeurt, moet u ervoor zorgen dat u de overeenkomende versies van de meest recente beschikbare versie van DbgSrv en WinDbg (klassiek) of WinDbg gebruikt. Zie Hulpprogramma's voor foutopsporing voor Windowsvoor meer informatie over het downloaden van de nieuwste versie.