Visual C++-bestanden opnieuw distribueren

Notitie

Bent u hier omdat u op zoek bent naar een download van een van de Visual C++ Runtime-bestanden? Ga naar de meest recente ondersteunde downloadpagina voor Visual C++ Redistributable .

Herdistribueerbare bestanden en licenties

De distributie van het Visual C++ Runtime Redistributable-pakket, de samenvoegmodules en afzonderlijke binaire bestanden is beperkt tot gelicentieerde Visual Studio gebruikers en is onderworpen aan Licentievoorwaarden voor Microsoft-software.

Wanneer u een toepassing implementeert, moet u ook de bestanden implementeren die nodig zijn om deze te ondersteunen. Als Microsoft een van deze bestanden verstrekt, controleert u of u ze opnieuw mag distribueren. U vindt een koppeling naar de Visual Studio licentievoorwaarden in de IDE. Selecteer in het dialoogvenster About Microsoft Visual Studio de koppeling Licentievoorwaarden. U kunt ook de relevante Licentievoorwaarden voor Microsoft-software en licenties downloaden uit de Visual Studio License Directory.

Zie Distributable codebestanden voor Microsoft Visual Studio 2022 om de 'REDIST-lijst' weer te geven waarnaar wordt verwezen in de sectie 'Distribueerbare code' van de Licentievoorwaarden voor Microsoft-software van Visual Studio 2022.

Zie Distribueerbare codebestanden voor Microsoft Visual Studio 2019 als u de "REDIST-lijst" wilt bekijken waarnaar wordt verwezen in de sectie "Distribueerbare code" van de Licentievoorwaarden voor Microsoft-software voor Visual Studio 2019.

Zie Distributable codebestanden voor Microsoft Visual Studio 2017 om de 'REDIST-lijst' weer te geven waarnaar wordt verwezen in de sectie 'Distribueerbare code' van de Licentievoorwaarden voor Microsoft-software van Visual Studio 2017.

Zie de 'Distribueerbare codebestanden voor Microsoft Visual Studio 2015' om de 'REDIST-lijst' weer te geven waarnaar wordt verwezen in de sectie 'Distribueerbare code' van de Licentievoorwaarden voor Microsoft-software voor Visual Studio 2015.

Zie Bepalen welke DLL's (Dynamic Link Libraries) u kunt herdistribueren en implementatievoorbeelden voor meer informatie over herdistribueerbare bestanden.

De herdistribueerbare bestanden zoeken

Als u herdistribueerbare bestanden wilt implementeren, kunt u de herdistribueerbare pakketten gebruiken die door Visual Studio zijn geïnstalleerd. In versies van Visual Studio sinds 2017 hebben deze bestanden de naam vc_redist.arm64.exe, vc_redist.x64.exe en vc_redist.x86.exe. In Visual Studio 2015, 2017 en 2019 zijn ze ook beschikbaar onder de namen vcredist_x86.exe, vcredist_x64.exe en (alleen 2015) vcredist_arm.exe.

De eenvoudigste manier om de herdistribueerbare bestanden te vinden, is door omgevingsvariabelen te gebruiken die zijn ingesteld in een opdrachtprompt voor ontwikkelaars. In Visual Studio 2022 bevinden de herdistribueerbare bestanden zich in de map %VCINSTALLDIR%Redist\MSVC\v143. In de nieuwste versie van Visual Studio 2019 vindt u de herdistribueerbare bestanden in de map %VCINSTALLDIR%Redist\MSVC\v142. In zowel Visual Studio 2017 als Visual Studio 2019 zijn de bestanden ook te vinden in %VCToolsRedistDir%. In Visual Studio 2015 vindt u deze bestanden in %VCINSTALLDIR%redist\<locale>, waarbij <locale> de landinstelling van de herdistribueerbare pakketten is.

In Visual Studio 2022 en 2019 maken samenvoegmodulebestanden deel uit van een optioneel installeerbaar onderdeel met de naam Visual C++ <version> Herdistribueerbare samenvoegmodules in het Visual Studio Installer. De samenvoegmodules worden standaard geïnstalleerd als onderdeel van een C++-installatie in Visual Studio 2017 en Visual Studio 2015. Wanneer ze zijn geïnstalleerd in Visual Studio 2022, kunt u de herdistribueerbare samenvoegmodules vinden in %VCINSTALLDIR%Redist\MSVC\v143\MergeModules.

In de nieuwste versie van Visual Studio 2019 vindt u de herdistribueerbare samenvoegmodules in %VCINSTALLDIR%Redist\MSVC\v142\MergeModules. In zowel Visual Studio 2019 als Visual Studio 2017 zijn ze ook te vinden in %VCToolsRedistDir%MergeModules. In Visual Studio 2015 zijn ze te vinden in Program Files [(x86)]\Common Files\Merge Modules.

De herdistribueerbare pakketten installeren

De Visual C++ Redistributable-pakketten installeren en registreren alle Visual C++-bibliotheken. Als u er een gebruikt, voert u deze uit als een vereiste op het doelsysteem voordat u uw toepassing installeert. U wordt aangeraden deze pakketten voor uw implementaties te gebruiken, omdat ze het automatisch bijwerken van de Visual C++-bibliotheken inschakelen. Zie Walkthrough: Een Visual C++-toepassing implementeren met behulp van het Visual C++-herdistribueerbare pakket voor een voorbeeld van het gebruik van deze pakketten.

Elk Visual C++ Redistributable-pakket controleert op het bestaan van een recentere versie op de computer. Als er een recentere versie wordt gevonden, is het pakket niet geïnstalleerd. In Visual Studio 2015 of hoger geven herdistribueerbare pakketten een foutbericht weer waarin staat dat de installatie is mislukt. Als een pakket de /quiet vlag gebruikt om uit te voeren, wordt er geen foutbericht weergegeven. In beide gevallen registreert het Microsoft installatieprogramma de fout en wordt er een foutresultaat geretourneerd naar de aanroeper.

In Visual Studio 2015 en hoger kunt u deze fout voorkomen door het register te controleren of er een recentere versie is geïnstalleerd. Het huidige geïnstalleerde versienummer wordt opgeslagen in de HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\VisualStudio\14.0\VC\Runtimes\{x86|x64|arm64}-sleutel.

Het versienummer is 14.0 voor Visual Studio 2015, 2017, 2019 en 2022, omdat het nieuwste redistributable pakket binair compatibel is met voorgaande versies tot 2015. De sleutel is arm64, x86of x64 afhankelijk van de geïnstalleerde vcredist versies voor het platform. (U moet alleen onder de Wow6432Node subsleutel controleren als u Regedit gebruikt om de versie van het geïnstalleerde x86-pakket op een x64-platform weer te geven.)

Het versienummer wordt opgeslagen in de REG_SZ tekenreekswaarde Version en ook in de set , MajorMinoren BldRbldREG_DWORD waarden. Als u een fout tijdens de installatie wilt voorkomen, moet u de installatie van het herdistribueerbare pakket overslaan als de momenteel geïnstalleerde versie recenter is.

Opdrachtregelopties voor de herdistribueerbare pakketten

Visual C++ Redistributable ondersteunt verschillende opdrachtregelopties. De opties /?, /h en /help tonen een dialoogvenster dat de beschikbare opties weergeeft. U kunt opgeven /install om het redistributable-pakket te installeren, /repair om te herstellen, of /uninstall om te verwijderen. Met de optie /layout kopieert u de volledige inhoud van het herdistribueerbare bestand in de huidige map.

Standaard installeert de Redistributable zijn inhoud en vraagt aan de gebruiker of er informatie nodig is en of het systeem opnieuw moet worden opgestart na de installatie. U kunt dit gedrag wijzigen met de volgende opties:

  • /passive: toont een voortgangsbalk als de Redistributable wordt geïnstalleerd, maar vereist verder geen tussenkomst van de gebruiker.
  • /quiet: geeft geen gebruikersinterface weer of vereist enige gebruikersinteractie. Gebruik /quiet voor volledig onbeheerde installaties.
  • /norestart: onderdrukt pogingen om opnieuw te starten. Standaard wordt er een logboekbestand gemaakt in %TEMP%.
  • /log filename.txt om u aan te melden bij een specifiek bestand.

Als u niet werkt vanaf een opdrachtprompt met verhoogde bevoegdheid, moet u reageren op een prompt voor gebruikersaccountbeheer om het installatieprogramma met beheerdersbevoegdheden toe te staan.

Met deze voorbeeldopdracht wordt x64 Redistributable geïnstalleerd. Het toont de voortgang van de installatie, maar vereist geen gebruikersinteractie naast het opnieuw opstarten:

vc_redist.x64.exe /install /passive /norestart

De herdistribueerbare samenvoegmodules installeren

Belangrijk

Samenvoegmodules (.msm bestanden) voor Herdistribueerbare bestanden van Visual C++ worden afgeschaft. We raden u niet aan deze te gebruiken voor toepassingsimplementatie. In plaats daarvan raden we de centrale implementatie van het Visual C++ Redistributable-pakket aan. Centrale implementatie door een herdistribueerbaar pakket maakt het mogelijk dat Microsoft de runtime bibliotheekbestanden onafhankelijk kan beheren. Het verwijderen van uw app kan geen invloed hebben op andere toepassingen die ook gebruikmaken van centrale implementatie.

Wanneer u een herdistribueerbaar pakket gebruikt voor centrale implementatie, bent u niet verantwoordelijk voor het bijhouden en onderhouden van de runtimebibliotheken. Anders moet u voor een update van de runtimebibliotheekbestanden uw .msi-installatieprogramma bijwerken en opnieuw implementeren. Uw app kan kwetsbaar zijn voor bugs of beveiligingsproblemen totdat u dat doet.

Herdistribueerbare samenvoegmodules moeten worden opgenomen in het Windows Installer-pakket (of een vergelijkbaar installatiepakket) dat u gebruikt om uw toepassing te implementeren. Zie Redistribute met behulp van samenvoegmodules voor meer informatie. Zie Walkthrough voor een voorbeeld: Een Visual C++-toepassing implementeren met behulp van een installatieproject.

Afzonderlijke herdistribueerbare bestanden installeren

Het is ook mogelijk om de herdistribueerbare DLL's rechtstreeks te installeren in de lokale map van de toepassing. De lokale toepassingsmap is de map die het uitvoerbare toepassingsbestand bevat. Om onderhoudsredenen raden we u niet aan deze installatielocatie te gebruiken.

Mogelijke runtimefouten

Als Windows een van de herdistribueerbare DLL's die zijn vereist voor uw toepassing niet kunt vinden, wordt mogelijk een bericht weergegeven dat vergelijkbaar is met deze: 'Deze toepassing kan niet worden gestart omdat library.dll niet is gevonden. Het opnieuw installeren van de toepassing kan dit probleem oplossen.

Als u dit soort fouten wilt oplossen, moet u ervoor zorgen dat het installatieprogramma van uw toepassing correct wordt gebouwd. Controleer of de herdistribueerbare bibliotheken correct worden geïmplementeerd op het doelsysteem. Zie Inzicht in de afhankelijkheden van een Visual C++-toepassing voor meer informatie.

Verwante inhoud

  • Last updated on