fungsi freeaddrinfo (ws2tcpip.h)

Artikel
03/04/2024

Fungsi freeaddrinfo membebaskan informasi alamat yang secara dinamis dialokasikan fungsi getaddrinfo dalam struktur addrinfo .

Sintaks

VOID WSAAPI freeaddrinfo(
  [in] PADDRINFOA pAddrInfo
);

Parameter

[in] pAddrInfo

Penunjuk ke struktur addrinfo atau daftar tertaut struktur addrinfo yang akan dibebaskan. Semua penyimpanan dinamis yang menunjuk ke dalam struktur atau struktur addrinfo juga dibebaskan.

Nilai kembali

Fungsi ini tidak mengembalikan nilai.

Keterangan

Fungsi freeaddrinfo membebaskan struktur addrinfo yang dialokasikan secara dinamis oleh fungsi ANSI getaddrinfo . Fungsi freeaddrinfo membebaskan struktur addrinfo awal yang ditujukan ke dalam parameter ai , termasuk buffer apa pun yang menjadi titik anggota struktur, kemudian terus membebaskan struktur addrinfo yang ditautkan oleh anggota ai_next struktur addrinfo . Fungsi freeaddrinfo terus membebaskan struktur tertaut hingga anggota NULLai_next ditemui.

Makro dalam file header Winsock menentukan nama fungsi mixed-case FreeAddrInfo dan struktur ADDRINFOT . Fungsi FreeAddrInfo ini harus dipanggil dengan parameter ai dari pointer jenis ADDRINFOT. Ketika UNICODE atau _UNICODE tidak ditentukan, FreeAddrInfo didefinisikan ke freeaddrinfo, versi ANSI dari fungsi, dan ADDRINFOT didefinisikan ke struktur addrinfo . Ketika UNICODE atau _UNICODE ditentukan, FreeAddrInfo didefinisikan ke FreeAddrInfoW, versi Unicode fungsi, dan ADDRINFOT didefinisikan ke struktur addrinfoW .

Dukungan untuk freeaddrinfo pada versi Windows yang lebih lama

Fungsi freeaddrinfo ditambahkan ke Ws2_32.dll pada Windows XP dan yang lebih baru.

Fungsi FreeAddrInfoW adalah versi Unicode dari freeaddrinfo. Fungsi FreeAddrInfoW ditambahkan ke Ws2_32.dll di Windows XP dengan Paket Layanan 2 (SP2). Fungsi FreeAddrInfoW tidak dapat digunakan pada versi Windows yang lebih lama dari Windows XP dengan SP2.

Windows Phone 8: Fungsi freeaddrinfo didukung untuk aplikasi Windows Phone Store di Windows Phone 8 dan yang lebih baru.

Windows 8.1 dan Windows Server 2012 R2: Fungsi freeaddrinfo dan FreeAddrInfoW didukung untuk aplikasi Windows Store di Windows 8.1, Windows Server 2012 R2, dan yang lebih baru.

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
DLL	Ws2_32.dll