BUG: Tidak dapat menemukan titik entri prosedur FreeAddrInfoW ketika Anda menjalankan aplikasi di Windows Server 2003 atau Windows XP

Ketika Anda menjalankan Unicode-enabled aplikasi yang menggunakan FreeAddrInfo Fungsi Windows soket, atau yang menggunakan penolong kelas seperti ATL::CSocketAddr pada komputer yang menjalankan Microsoft Windows Server 2003 atau Microsoft Windows XP, Anda mungkin menerima pesan galat berikut:

Ws2_32.dll perpustakaan tidak ekspor simbol FreeAddrInfoW yang harus Anda miliki untuk menggunakan versi Unicode FreeAddrInfo fungsi.

Untuk mengatasi masalah ini, ikuti langkah-langkah berikut:

1. Salin berkas Atlsocket.h ke direktori apapun yang Anda ingin gunakan. File ini terletak di direktori berikut:
   Program files Microsoft Visual Studio.NET 2003\Vc7\atlmfc\include
2. Tambahkan blok berikut kode untuk salinan berkas Atlsocket.h yang Anda buat pada langkah 1.

   //Atlsocket.h
   #pragma comment(lib, "ws2_32.lib")
   #pragma comment(lib, "mswsock.lib")
   //Start of Addition
   #if _WIN32_WINNT < 0x0502
     #define ADDRINFOT addrinfo
     #define GetAddrInfo getaddrinfo
     #define FreeAddrInfo freeaddrinfo
   #endif
   //End of Addition namespace ATL

3. Mulai Microsoft Visual C++.
4. Pada Alat menu, klik Opsi. Di panel kiri Opsi kotak dialog, memperluas Proyek, lalu klik VC ++ direktori.
   
   Catatan Jika Anda menggunakan Visual C++ Express Edition, memperluas Proyek-proyek dan solusi di panel kiri Opsi kotak dialog, dan kemudian klik VC ++ direktori.
5. Di bawah Tampilkan direktori untuk, klik Termasuk file. Kemudian, tambahkan direktori di mana versi modifikasi dari Atlsocket.h file terletak ke bagian atas daftar.
6. Membangun aplikasi

Microsoft telah mengkonfirmasi bahwa ini adalah bug dalam produk Microsoft sebagaimana didaftar di dalam bagian "Berlaku untuk".

Langkah-langkah untuk menyalin masalah

1. Mulai Microsoft Visual Studio.NET 2003.
2. Pada Berkas menu, titikBaru, lalu klik Project.
3. KlikVisual C++ proyek di bawah Jenis proyek. Kemudian, klik Proyek konsol Win32 di bawahPola acu.
4. Dalam Nama kotak, jenisSampel, lalu klik Oke.
5. Dalam Aplikasi Win32 Wizard dialog kotak, klik untuk memilih The ATL dan Menambahkan dukungan untuk kotak centang di bawah Pengaturan aplikasi, dan kemudian Klik Menyelesaikan.
6. Dalam Sample.cpp file, menggantikan kode standar yang ada dengan kode berikut.

   #include "stdafx.h"
   #include <atlsocket.h>
   
   void _tmain()
   {
   	CSocketAddr aSocketAddr;
   }

7. Dalam solusi Explorer, klik kanan proyek node, dan kemudian klik Properti.
8. Dalam proyek Halaman properti kotak dialog, Klik General di bawah Konfigurasi propertidalam pane kiri. Dalam pane kanan, mengatur Karakter Set properti untuk Menggunakan Set karakter Unicode. KlikOke.
9. Pada Bangun menu, klik Bangun Solusi untuk membangun aplikasi. Anda mungkin menyadari bahwa tidak ada kesalahan kompilasi atau menghubungkan kesalahan terjadi selama proses membangun.
10. Pada Debug menu, klik Mulai Tanpa Debugging. Anda dapat melihat bahwa Anda menerima pesan galat yang dijelaskan di bagian "Gejala".

Pada Windows Server 2003 dan Windows XP, Windows soket fungsi baru ditambahkan ke Windows Socket API. GetAddrInfo dan FreeAddrInfo dua baru Windows soket fungsi yang ditambahkan untuk berurusan dengan Versi 6 (IPv6) protokol Internet dan Internet Protocol versi 4 (IPv4) alamat. Perpustakaan Template aktif (ATL) 7.1 CSocketAddr kelas menggunakan fungsi-fungsi ini baru Windows soket untuk memberikan dukungan untuk IPv6. Lain ATL dan Microsoft Foundation Classes (MFC) kelas juga digunakan CSocketAddr kelas untuk memberikan dukungan IPv6. Sebagai contoh, CAsyncSocket kelas dan CSMTPConnection kelas penggunaan CSocketAddr kelas.

Catatan The CAsyncSocket kelas adalah kelas MFC. The CSMTPConnection kelas adalah kelas ATL.

Masalah yang dijelaskan dalam "Gejala" bagian yang terjadi dalam aplikasi diaktifkan Unicode yang menggunakan FreeAddrInfo Soket Windows fungsi pada komputer yang menjalankan Windows Server 2003 atau Windows XP. Karena ATL CSocketAddr kelas menggunakan FreeAddrInfo fungsi, masalah yang sama juga terjadi di ATL 7.1. Setiap kelas di ATL 7,1 dan MFC 7.1 yang menggunakan CSocketAddr kelas untuk mengaktifkan dukungan IPv6 mencerminkan perilaku ini. Sebagai contoh, CAsyncSocket kelas dan CSMTPConnection kelas penggunaan CSocketAddr kelas.

ATL server kelas seperti CAtlHttpClient dan CSoapSocketClientT menggunakan ZEvtSyncSocket kelas, dan menampilkan kesalahan yang sama. Perilaku ini terjadi karena ZEvtSyncSocket menggunakan internal kelas CSocketAddr kelas dalam pelaksanaannya.

Catatan The CAtlHttpClient kelas menyediakan dukungan klien HTTP. The CSoapSocketClientT kelas menyediakan dukungan klien layanan XML Web.

Untuk informasi lebih lanjut tentang perubahan yang telah dibuat untuk ATL, kunjungi situs Web Microsoft Developer Network (MSDN) berikut:Untuk informasi lebih lanjut tentang fungsi soket Windows baru yang telah ditambahkan ke soket Windows API, kunjungi Website MSDN site: