Fungsi FreeAddrInfoW (ws2tcpip.h)

Artikel
08/28/2023

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