FreeAddrInfoEx

FreeAddrInfoEx 関数 (ws2tcpip.h) は、GetAddrInfoEx 関数が addrinfoex 構造体に動的に確保したアドレス情報を解放する。

FreeAddrInfoEx pAddrInfoEx

pAddrInfoEx : [var] 解放する addrinfoex 構造体、または addrinfoex 構造体のリンクリストへのポインタ。addrinfoex 構造体内から指されている動的に確保されたすべての領域も解放される。

(プラグイン / モジュール : ws2_32.dll)

解説

FreeAddrInfoEx 関数 (ws2tcpip.h) は、GetAddrInfoEx 関数が addrinfoex
構造体に動的に確保したアドレス情報を解放する。

[戻り値]
この関数は値を返さない。

[備考]
FreeAddrInfoEx 関数は、GetAddrInfoEx 関数によって動的に確保された addrinfoex
構造体を解放する。FreeAddrInfoEx 関数は、まず pAddrInfo パラメータが指す最初の addrinfoex
構造体を、構造体メンバが指すバッファ類も含めて解放し、続いて addrinfoex 構造体の ai_next
メンバによってリンクされている addrinfoex 構造体を順次解放していく。FreeAddrInfoEx 関数は、ai_next
メンバが NULL になるまでリンクされた構造体の解放を続ける。UNICODE または _UNICODE
が定義されている場合、FreeAddrInfoEx は Unicode 版の FreeAddrInfoExW
として定義され、ADDRINFOEX は addrinfoexW 構造体として定義される。UNICODE または _UNICODE
が定義されていない場合、FreeAddrInfoEx は ANSI 版の FreeAddrInfoExA
として定義され、ADDRINFOEX は addrinfoexA 構造体として定義される。Windows 8.1 および Windows
Server 2012 R2: FreeAddrInfoExW 関数は、Windows 8.1、Windows Server 2012
R2 以降の Windows ストアアプリでサポートされる。

情報