Fungsi FreeAddrInfoW (ws2tcpip.h)
Fungsi FreeAddrInfoW membebaskan informasi alamat yang dialokasikan fungsi GetAddrInfoW secara dinamis dalam struktur addrinfoW .
Sintaks
VOID WSAAPI FreeAddrInfoW(
[in] PADDRINFOW pAddrInfo
);
Parameter
[in] pAddrInfo
Penunjuk ke struktur addrinfoW atau daftar tertaut struktur addrinfoW yang akan dikosongkan. Semua penyimpanan dinamis yang menunjuk ke dalam struktur atau struktur addrinfoW juga dikosongkan.
Nilai kembali
Fungsi ini tidak mengembalikan nilai.
Keterangan
Fungsi FreeAddrInfoW membebaskan struktur addrinfoW yang dialokasikan secara dinamis oleh fungsi Unicode GetAddrInfoW . Fungsi FreeAddrInfoW membebaskan struktur addrinfoW awal yang diarahkan ke dalam parameter pAddrInfo , termasuk buffer apa pun yang menjadi titik anggota struktur, kemudian terus membebaskan struktur addrinfoW yang ditautkan oleh ai_next anggota struktur addrinfoW . Fungsi FreeAddrInfoW terus membebaskan struktur tertaut hingga anggota ai_next NULL ditemui.
Makro dalam file header Winsock menentukan nama fungsi kasus campuran FreeAddrInfo dan struktur ADDRINFOT . Fungsi FreeAddrInfo ini harus dipanggil dengan parameter pAddrInfo dari pointer jenis ADDRINFOT. Ketika UNICODE atau _UNICODE ditentukan, FreeAddrInfo didefinisikan ke FreeAddrInfoW, versi Fungsi Unicode, dan ADDRINFOT didefinisikan ke struktur addrinfoW . Ketika UNICODE atau _UNICODE tidak ditentukan, FreeAddrInfo didefinisikan ke freeaddrinfo, versi ANSI dari fungsi, dan ADDRINFOT didefinisikan ke struktur addrinfo .
Windows 8.1 dan Windows Server 2012 R2: Fungsi ini didukung untuk aplikasi Windows Store di Windows 8.1, Windows Server 2012 R2, dan yang lebih baru.
Catatan
Header ws2tcpip.h mendefinisikan FreeAddrInfo sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosem UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 8.1, Windows Vista [aplikasi desktop | Aplikasi UWP] |
| Server minimum yang didukung | Windows Server 2003 [aplikasi desktop | Aplikasi UWP] |
| Target Platform | Windows |
| Header | ws2tcpip.h |
| Pustaka | Ws2_32.lib |
| DLL | Ws2_32.dll |