Delen via

Het hulpprogramma Checkv4.exe gebruiken

  • Artikel

Belangrijk

Het hulpprogramma Checkv4.exe wordt niet verzonden in de Windows Software Development Kit (SDK) voor Windows 8, noch in latere versies van de Windows SDK.

Het hulpprogramma Checkv4.exe is ontworpen om u te voorzien van een partner voor het overzetten van code; een hulpprogramma dat uw codebasis met u doorloopt, potentiële problemen identificeert of code markeert die baat kan hebben bij functies of structuren die geschikt zijn voor IPv6 en aanbevelingen doet. Met het hulpprogramma Checkv4.exe wordt het wijzigen van een bestaande IPv4-toepassing ter ondersteuning van IPv6 veel eenvoudiger.

Het hulpprogramma Checkv4.exe is geïnstalleerd als onderdeel van de Microsoft Windows Software Development Kit (SDK) die is uitgebracht voor Windows Vista en latere SDK's (tot, maar niet inclusief, de Windows Software Development Kit (SDK) voor Windows 8).

Een eerdere versie van het Checkv4.exe hulpprogramma met meer beperkte functies werd ook beschikbaar gesteld als onderdeel van de eerdere Microsoft IPv6 Technology Preview voor Windows 2000.

In de volgende secties wordt beschreven hoe u het hulpprogramma Checkv4.exe gebruikt en wordt vervolgens uitgelegd hoe u een bestaande IPv4-toepassing kunt wijzigen om IPv6 te ondersteunen.

Aanbevelingen voor het uitvoeren van Checkv4.exe

  • Het Checkv4.exe hulpprogramma is eenvoudig. Voer gewoon Checkv4.exe uit op de opdrachtregel met de naam van het bestand dat u wilt controleren als de parameter. Checkv4.exe het bestand parseert en feedback geeft over waar IPv6-overdrachtsproblemen in dat bestand bestaan. Door de Checkv4.exe in het pad van uw computer te plaatsen, is het uitvoeren van het Checkv4.exe hulpprogramma vanaf elke locatie in de structuur van de broncodemap veel eenvoudiger. Als u bijvoorbeeld Checkv4.exe in %windir% plaatst, kunt u Checkv4.exe starten vanuit elke map op uw computer zonder het bijbehorende pad op te geven.

  • Geef de volgende opdracht uit bij de opdrachtprompt om het bestand Simplec.c te parseren:

    Checkv4 simplec.c

    Houd er rekening mee dat sommige aanbevelingen van het Checkv4.exe hulpprogramma alleen structuren nodig hebben die alleen beschikbaar zijn in recente versies van het Ws2tcpip.h headerbestand, zoals de SOCKADDR_IN6 structuur. Deze headerbestanden zijn opgenomen in de Windows SDK die is uitgebracht voor Windows Vista en hoger. Deze headerbestanden zijn ook opgenomen in de eerdere Sdk (Platform Software Development Kit) die is uitgebracht voor Windows Server 2003.

    In de volgende schermafbeelding ziet u de resultaten van het gebruik van het hulpprogramma Checkv4.exe in het simplec.c-bestand dat is opgenomen in bijlage A:

    checkv4.exe rapporteert ipv6-incompatibiliteit in het bestand simplec.c

    In de volgende schermafbeelding ziet u de resultaten van het gebruik van het hulpprogramma Checkv4.exe in het bestand Simples.c, dat ook is opgenomen in bijlage A:

    checkv4.exe rapporteert ipv6-incompatibiliteit in het bestand simples.c

Het wijzigingsproces van de toepassing: waar moet ik beginnen

Er is een aanbevolen procedure die is gekoppeld aan het toevoegen van IPv6-functionaliteit aan toepassingen. Het volgen van deze reeks is nuttig, omdat ontwikkelaars hiermee ervoor kunnen zorgen dat alle stappen die nodig zijn voor het wijzigen van een bestaande IPv4-toepassing ter ondersteuning van IPv6, worden uitgevoerd. Voor bepaalde toepassingen kan een van deze reeksen meer aandacht nodig zijn; Een systeemservice heeft bijvoorbeeld waarschijnlijk minder problemen met de gebruikersinterface dan een grafisch programma voor bestandsoverdracht (FTP).

IPv4-toepassingen wijzigen ter ondersteuning van IPv6-

  1. Corrigeer structuren en declaraties om IPv6- en IPv4-compatibiliteit mogelijk te maken.

  2. Wijzig functieaanroepen om te profiteren van IPv6-functies, zoals de getaddrinfo- en getnameinfo functies.

  3. Controleer de broncode voor het gebruik van in code vastgelegde IPv4-adressen, zoals het loopback-adres of het gebruik van andere letterlijke tekenreeksen.

  4. Voer een grondig overzicht van de gebruikersinterface uit, inclusief informatieve dialoogvensters. Denk na of het geschikt is voor IPv6-toepassingen om informatie op basis van IP-adressen te specificeren of te verstrekken.

  5. Bepaal of uw toepassing afhankelijk is van onderliggende protocollen, zoals RPC, en breng de juiste programmatische wijzigingen aan om IPv6-adressen te verwerken.

  6. Gebruik de vlag compileertijd IPV6STRICT bij het compileren van toepassingen in Windows XP en hoger. Deze vlag resulteert in incompatibele code die niet kan worden gecompileerd, als volgt:

    Windows Sockets 1.x-toepassingen met incompatibele code kunnen niet worden gecompileerd en retourneren het foutbericht 'WINSOCK2 Vereist'.

    Windows Sockets 2.x-toepassingen met incompatibele code veroorzaken een compilatietijdfout voor elk exemplaar van incompatibele code. Er wordt een foutbericht gegenereerd in de volgende indeling:

    [file name] ([line number]) : [error message] '[symbol]_IPV6INCOMPATIBLE'

    Bijvoorbeeld:

    sample.c(8) : error C2065: 'gethostbyaddr_IPV6INCOMPATIBLE' : undeclared identifier