Menggunakan utilitas Checkv4.exe

Penting

Utilitas Checkv4.exe tidak dikirim di Windows Software Development Kit (SDK) untuk Windows 8, atau di versi Windows SDK yang lebih baru.

Utilitas Checkv4.exe dirancang untuk memberi Anda mitra porting kode; utilitas yang melaju melalui basis kode Anda dengan Anda, mengidentifikasi potensi masalah atau menyoroti kode yang dapat memperoleh manfaat dari fungsi atau struktur berkemampuan IPv6, dan membuat rekomendasi. Dengan utilitas Checkv4.exe, tugas memodifikasi aplikasi IPv4 yang ada untuk mendukung IPv6 menjadi jauh lebih mudah.

Utilitas Checkv4.exe diinstal sebagai bagian dari Microsoft Windows Software Development Kit (SDK) yang dirilis untuk Windows Vista dan SDK yang lebih baru (hingga, tetapi tidak termasuk, Windows Software Development Kit (SDK) untuk Windows 8).

Versi utilitas Checkv4.exe yang lebih lama dengan fitur yang lebih terbatas juga tersedia sebagai bagian dari Pratinjau Teknologi Microsoft IPv6 sebelumnya untuk Windows 2000.

Bagian berikut menjelaskan cara menggunakan utilitas Checkv4.exe , lalu menjelaskan pendekatan yang direkomendasikan untuk memodifikasi aplikasi IPv4 yang ada untuk mendukung IPv6.

Rekomendasi untuk Menjalankan Checkv4.exe

• Utilitas Checkv4.exe mudah. Cukup jalankan Checkv4.exe di baris perintah dengan nama file yang ingin Anda periksa sebagai parameter . Checkv4.exe mengurai file dan memberikan umpan balik tentang tempat masalah porting IPv6 ada dalam file tersebut. Menempatkan Checkv4.exe ke jalur komputer Anda membuat menjalankan utilitas Checkv4.exe dari mana saja dalam struktur direktori kode sumber Anda jauh lebih mudah. Misalnya, menempatkan Checkv4.exe ke %windir% memungkinkan Anda meluncurkan Checkv4.exe dari direktori apa pun di komputer Anda tanpa menyertakan jalurnya.

• Terbitkan perintah berikut pada prompt perintah untuk mengurai file Simplec.c:

  Checkv4 simplec.c

  Perhatikan bahwa beberapa rekomendasi yang dibuat oleh utilitas Checkv4.exe memerlukan struktur yang hanya tersedia dalam versi terbaru file header Ws2tcpip.h, seperti struktur SOCKADDR_IN6. File header ini disertakan dalam Windows SDK yang dirilis untuk Windows Vista dan yang lebih baru. File header ini juga disertakan dalam Platform Software Development Kit (SDK) sebelumnya yang dirilis untuk Windows Server 2003.

  Cuplikan layar berikut menampilkan hasil penggunaan utilitas Checkv4.exe pada file Simplec.c yang disertakan dalam Lampiran A:

  

  Cuplikan layar berikut menampilkan hasil penggunaan utilitas Checkv4.exe pada file Simples.c, yang juga disertakan dalam Lampiran A:

  

Proses Modifikasi Aplikasi: Tempat Memulai

Ada prosedur yang direkomendasikan yang terkait dengan penambahan kemampuan IPv6 ke aplikasi. Mengikuti urutan ini bermanfaat, karena memungkinkan pengembang untuk memastikan bahwa semua langkah yang diperlukan untuk memodifikasi aplikasi IPv4 yang ada untuk mendukung IPv6 diambil. Aplikasi tertentu mungkin memerlukan perhatian yang lebih luas pada salah satu urutan ini; misalnya, layanan sistem kemungkinan akan memiliki lebih sedikit masalah antarmuka pengguna daripada program transfer file grafis (FTP).

Untuk memodifikasi aplikasi IPv4 untuk mendukung IPv6

1. Perbaiki struktur dan deklarasi untuk mengaktifkan kompatibilitas IPv6 dan IPv4.

2. Ubah panggilan fungsi untuk memanfaatkan fungsi berkemampuan IPv6, seperti fungsi getaddrinfo dan getnameinfo.

3. Tinjau kode sumber untuk penggunaan alamat IPv4 yang dikodekan secara permanen seperti alamat loopback, atau penggunaan string harfiah lainnya.

4. Lakukan tinjauan menyeluruh tentang antarmuka pengguna, termasuk kotak dialog informasi. Pikirkan apakah sesuai untuk aplikasi berkemampuan IPv6 untuk menentukan atau memberikan informasi berbasis alamat IP.

5. Tentukan apakah aplikasi Anda bergantung pada protokol yang mendasar, seperti RPC, dan buat perubahan terprogram yang sesuai untuk menangani alamat IPv6.

6. Gunakan bendera waktu kompilasi IPV6STRICT saat mengkompilasi aplikasi di Windows XP dan yang lebih baru. Bendera ini menghasilkan kode yang tidak kompatibel gagal dikompilasi, sebagai berikut:

   Aplikasi Windows Sockets 1.x dengan kode yang tidak kompatibel gagal dikompilasi dan mengembalikan pesan kesalahan "WINSOCK2 Diperlukan."

   Aplikasi Windows Sockets 2.x dengan kode yang tidak kompatibel menyebabkan kesalahan waktu kompilasi untuk setiap instans kode yang tidak kompatibel. Pesan kesalahan dihasilkan dalam format berikut:

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

   Contohnya:

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