Externe foutopsporing voor een C++-project in Visual Studio

Als u fouten wilt opsporen in een Visual Studio-toepassing op een andere computer, installeert en voert u de externe hulpprogramma's uit op de computer waarop u uw app implementeert, configureert u uw project om verbinding te maken met de externe computer vanuit Visual Studio en implementeert en voert u de app uit.

Zie Fouten opsporen in een geïnstalleerd app-pakketvoor informatie over externe foutopsporing in Universal Windows-apps (UWP).

Eisen

Het externe foutopsporingsprogramma wordt ondersteund in Windows 7 en nieuwere versies van Windows Server vanaf Windows Server 2008 Service Pack 2. Zie Vereistenvoor een volledige lijst met vereisten.

Notitie

Foutopsporing tussen twee computers die zijn verbonden via een proxy, wordt niet ondersteund. Foutopsporing via een verbinding met hoge latentie of lage bandbreedte, zoals inbelinternet of via internet in landen/regio's, wordt niet aanbevolen en kan mislukken of onaanvaardbaar traag zijn.

De externe hulpprogramma's downloaden en installeren

Download en installeer op het externe apparaat of de server waarop u fouten wilt opsporen in plaats van op de Visual Studio-computer de juiste versie van de externe hulpprogramma's via de koppelingen in de volgende tabel.

• Download de meest recente externe hulpprogramma's voor uw versie van Visual Studio. De nieuwste versie van externe hulpprogramma's is compatibel met eerdere Versies van Visual Studio, maar eerdere versies van externe hulpprogramma's zijn niet compatibel met latere Versies van Visual Studio. (Als u bijvoorbeeld Visual Studio 2019 gebruikt, downloadt u de nieuwste update van de externe hulpprogramma's voor Visual Studio 2019. In dit scenario downloadt u de externe hulpprogramma's voor Visual Studio 2022 niet.)
• Download de externe hulpprogramma's met dezelfde architectuur als de computer waarop u ze installeert. Als u bijvoorbeeld fouten wilt opsporen in een 32-bits app op een externe computer met een 64-bits besturingssysteem, installeert u de 64-bits externe hulpprogramma's.
• Als u externe foutopsporing uitvoert voor een ARM64EC-toepassing op een ARM64-apparaat, installeert u de externe ARM64-hulpprogramma's en start u vervolgens het x64-foutopsporingsprogramma dat met deze hulpprogramma's wordt geïnstalleerd. Dit is te vinden onder: Program Files (x86)\Microsoft Visual Studio<versie>\Common7\IDE\Remote Debugger\x64.

Versie	Verbinden	Notities
Visual Studio 2022	Externe hulpprogramma's	Compatibel met alle Visual Studio 2022-versies. Download de versie die overeenkomt met het besturingssysteem van uw apparaat (x86, x64 (AMD64) of ARM64. Zie Het downloaden van bestanden opheffen in oudere versies van Windows Server voor hulp bij het downloaden van de externe hulpprogramma's.
Visual Studio 2019	Externe hulpprogramma's	Externe hulpprogramma's voor Visual Studio 2019 zijn beschikbaar via My.VisualStudio.com. Als u hierom wordt gevraagd, kunt u deelnemen aan de gratis Visual Studio Dev Essentials programma of u aanmelden met uw Visual Studio-abonnements-id. Download de versie die overeenkomt met het besturingssysteem van uw apparaat (x86, x64 (AMD64) of ARM64. Zie Het downloaden van bestanden opheffen in oudere versies van Windows Server voor hulp bij het downloaden van de externe hulpprogramma's.
Visual Studio 2017	Externe hulpprogramma's	Externe hulpprogramma's voor Visual Studio 2017 zijn beschikbaar via My.VisualStudio.com. Als u hierom wordt gevraagd, kunt u deelnemen aan de gratis Visual Studio Dev Essentials programma of u aanmelden met uw Visual Studio-abonnements-id. Download de versie die overeenkomt met het besturingssysteem van uw apparaat (x86, x64 (AMD64) of ARM64. Zie op Windows Server Het downloaden van bestanden deblokkeren voor hulp bij het downloaden van de externe hulpprogramma's.
Visual Studio 2015	Externe hulpprogramma's	Externe hulpprogramma's voor Visual Studio 2015 zijn beschikbaar via My.VisualStudio.com. Als u hierom wordt gevraagd, kunt u deelnemen aan de gratis Visual Studio Dev Essentials programma of u aanmelden met uw Visual Studio-abonnements-id. Zie op Windows Server Het downloaden van bestanden deblokkeren voor hulp bij het downloaden van de externe hulpprogramma's.
Visual Studio 2013	Externe hulpprogramma's	Downloadpagina in documentatie voor Visual Studio 2013
Visual Studio 2012	Externe hulpprogramma's	Downloadpagina in documentatie voor Visual Studio 2012

U kunt het externe foutopsporingsprogramma uitvoeren door msvsmon.exe te kopiëren naar de externe computer in plaats van de externe hulpprogramma's te installeren. De configuratiewizard voor externe foutopsporing (rdbgwiz.exe) is echter alleen beschikbaar wanneer u de externe hulpprogramma's installeert. Mogelijk moet u de wizard gebruiken voor configuratie als u het externe foutopsporingsprogramma als een service wilt uitvoeren. Zie (optioneel) Het externe foutopsporingsprogramma configureren als een servicevoor meer informatie.

Notitie

• Als u fouten wilt opsporen in Windows 10- of hoger-apps op ARM-apparaten, gebruikt u ARM64, die beschikbaar is met de nieuwste versie van de externe hulpprogramma's.
• Als u fouten wilt opsporen in Windows 10-apps op Windows RT-apparaten, gebruikt u ARM, dat alleen beschikbaar is in de download van externe hulpprogramma's van Visual Studio 2015.

Tip

In sommige scenario's kan het meest efficiënt zijn om het externe foutopsporingsprogramma uit te voeren vanuit een bestandsshare. Zie Het externe foutopsporingsprogramma uitvoeren vanuit een bestandssharevoor meer informatie.

Het externe foutopsporingsprogramma instellen

1. Zoek en start op de externe computer de Remote Debugger in het menu Start.

   Als u geen beheerdersmachtigingen op de externe computer hebt, klikt u met de rechtermuisknop op de externe foutopsporingsprogramma-app en selecteert u Als administrator uitvoeren. Anders start u het gewoon normaal.

   Als u van plan bent een proces te koppelen dat wordt uitgevoerd als beheerder of wordt uitgevoerd onder een ander gebruikersaccount (zoals IIS), klikt u met de rechtermuisknop op de Remote Debugger-app en selecteert u Als administrator uitvoeren. Voor meer informatie, zie Het externe foutopsporingsprogramma uitvoeren als beheerder.

2. De eerste keer dat u het externe foutopsporingsprogramma start (of voordat u het hebt geconfigureerd), wordt de wizard configuratie voor externe foutopsporing weergegeven.

   Kies in de meeste scenario's Volgende totdat u bij de pagina Windows Firewall configureren van de wizard bent.

   

3. Selecteer ten minste één netwerktype waarvoor u de externe hulpprogramma's wilt gebruiken. Als de computers zijn verbonden via een domein, moet u het eerste item kiezen. Als de computers zijn verbonden via een werkgroep of thuisgroep, kiest u het tweede of derde item indien van toepassing.

   Selecteer vervolgens Voltooien om het externe foutopsporingsprogramma te starten.

4. Wanneer de configuratie is voltooid, wordt het venster Remote Debugger weergegeven.

   

   Het externe foutopsporingsprogramma wacht nu op een verbinding. Gebruik de servernaam en het poortnummer dat wordt weergegeven om de configuratie van de externe verbinding in Te stellen in Visual Studio.

Als u het externe foutopsporingsprogramma wilt stoppen, selecteert u Bestand>Afsluiten. U kunt het opnieuw starten vanuit het menu Start of vanaf de opdrachtregel:

<Remote debugger installation directory>\msvsmon.exe

Notitie

Als u machtigingen wilt toevoegen voor extra gebruikers, de verificatiemodus of het poortnummer voor het externe foutopsporingsprogramma wilt wijzigen, raadpleegt u Het externe foutopsporingsprogramma configureren.

Externe foutopsporing in een C++-project

In de volgende procedure is het pad van het project C:\remotetemp en de naam van de externe computer is MySurface.

1. Een C++-consoletoepassing maken met de naam CppConsoleApp

2. Stel een onderbrekingspunt ergens in de toepassing in die gemakkelijk te bereiken is, bijvoorbeeld in CppConsoleApp.cpp, in de functie main.

3. Klik in Solution Explorer met de rechtermuisknop op het project en selecteer Eigenschappen. Open het tabblad Foutopsporing.

4. Stel de -debugger in om te starten met de Externe Windows Debugger.

   nl-NL:

5. Breng de volgende wijzigingen aan in de eigenschappen:

   Instelling	Waarde
   Externe opdracht	C:\remotetemp\CppConsoleApp.exe
   Werkdirectory	C:\remotetemp
   Naam van externe server	MySurface:poortnummer
   Verbinding	Op afstand met Windows-verificatie
   Foutopsporingsprogrammatype	Alleen voor interne toepassingen
   Uitrolmap	C:\remotetemp
   Aanvullende bestanden die moeten worden geïmplementeerd	$(ProjectDir)\data

   Als u extra mappen implementeert en alle bestanden in een map wilt implementeren in dezelfde map, geeft u een mapnaam op.

   Zie Project-instellingen voor een C++-configuratie voor foutopsporingvoor meer informatie over de eigenschappen.

6. Klik in Solution Explorer met de rechtermuisknop op de oplossing en kies Configuration Manager-.

7. Voor de configuratie Debug schakelt u het selectievakje Deploy in.

   

8. Foutopsporing starten (Foutopsporing > start foutopsporingof F5-).

9. Het uitvoerbare bestand wordt automatisch geïmplementeerd op de externe computer.

10. Voer desgevraagd netwerkreferenties in om verbinding te maken met de externe computer.

    De vereiste inloggegevens zijn specifiek voor de beveiligingsconfiguratie van uw netwerk. Op een domeincomputer kunt u bijvoorbeeld een beveiligingscertificaat kiezen of uw domeinnaam en wachtwoord invoeren. Op een niet-domeincomputer kunt u de computernaam en een geldige gebruikersnaam invoeren, zoals MySurface\name@something.com, samen met het juiste wachtwoord.

11. Op de Visual Studio-computer ziet u dat de uitvoering is gestopt op het onderbrekingspunt.

    Tip

    U kunt de bestanden ook implementeren als een afzonderlijke stap. Klik in Solution Explorer met de rechtermuisknop op het projectknooppunt en kies vervolgens Implementeren.

    Als u niet-codebestanden hebt die vereist zijn voor de toepassing, kunt u deze opgeven in een door puntkomma's gescheiden lijst in Aanvullende bestanden om te implementeren op de pagina Debugger waarbij de externe Windows-foutopsporingsprogramma is geselecteerd.

    U kunt ook de bestanden in uw project opnemen en de eigenschap Inhoud instellen op Ja- op de pagina Eigenschappen voor elk bestand. Deze bestanden worden gekopieerd naar de Deployment Directory opgegeven op de pagina Debugger eigenschappen met Remote Windows Debugger geselecteerd. U kunt ook het itemtype wijzigen in Bestand kopiëren en daar aanvullende eigenschappen opgeven als u de bestanden wilt kopiëren naar een submap van de Implementatiemap.

Debugging instellen met externe symbolen

U moet fouten in uw code kunnen opsporen met de symbolen die u op de Visual Studio-computer genereert. De prestaties van het externe foutopsporingsprogramma zijn veel beter wanneer u lokale symbolen gebruikt.

Als u externe symbolen moet gebruiken, moet u de externe symbolen in Visual Studio opgeven door een Windows-bestandsshare toe te voegen aan het zoekpad voor symbolen in Extra > Opties > Foutopsporing > Symbolen.

Verwante inhoud

• foutopsporing in Visual Studio
• Bekijk eerst het foutopsporingsprogramma
• De Windows Firewall configureren voor externe foutopsporing
• Poorttoewijzingen voor externe debuggers
• externe foutopsporing ASP.NET op een externe IIS-computer
• foutopsporing op afstand en probleemoplossing