FreeAddrInfoEx 関数 (ws2tcpip.h)

FreeAddrInfoEx 関数は、GetAddrInfoEx 関数が addrinfoex 構造体で動的に割り当てるアドレス情報を解放します。

構文

void WSAAPI FreeAddrInfoEx(
  [in] PADDRINFOEXA pAddrInfoEx
);

パラメーター

[in] pAddrInfoEx

解放する addrinfoex 構造体または addrinfoex 構造体のリンクされたリストへのポインター。 addrinfoex 構造体または構造体内を指す動的ストレージもすべて解放されます。

戻り値

この関数は値を返しません。

注釈

FreeAddrInfoEx 関数は、GetAddrInfoEx 関数によって動的に割り当てられた addrinfoex 構造体を解放します。 FreeAddrInfoEx 関数は、構造体メンバーがポイントするバッファーを含め、pAddrInfo パラメーターで指されている最初の addrinfoex 構造体を解放し、addrinfoex 構造体の ai_next メンバーによってリンクされている addrinfoex 構造体を解放し続けます。 FreeAddrInfoEx 関数は、NULLai_next メンバーが検出されるまで、リンクされた構造体を解放し続けます。

UNICODE または_UNICODEが定義されている場合、 FreeAddrInfoEx は FreeAddrInfoExW に定義され、Unicode バージョンの関数と ADDRINFOEX は addrinfoexW 構造体に定義されます。 UNICODE または_UNICODEが定義されていない場合、 FreeAddrInfoEx は FreeAddrInfoExA に定義され、関数の ANSI バージョン、 ADDRINFOEX は addrinfoexA 構造体に定義されます。

Windows 8.1およびWindows Server 2012 R2: FreeAddrInfoExW 関数は、Windows 8.1、Windows Server 2012 R2 以降の Windows ストア アプリでサポートされています。

要件

こちらもご覧ください

GetAddrInfoEx

addrinfoex