freeaddrinfo 関数 (ws2tcpip.h)
freeaddrinfo 関数は、getaddrinfo 関数が addrinfo 構造体で動的に割り当てるアドレス情報を解放します。
構文
VOID WSAAPI freeaddrinfo(
[in] PADDRINFOA pAddrInfo
);
パラメーター
[in] pAddrInfo
解放する addrinfo 構造体または addrinfo 構造体のリンクされたリストへのポインター。 addrinfo 構造体または構造体内で指されているすべての動的ストレージも解放されます。
戻り値
この関数は値を返しません。
注釈
freeaddrinfo 関数は、ANSI getaddrinfo 関数によって動的に割り当てられた addrinfo 構造体を解放します。 freeaddrinfo 関数は、ai パラメーターで指す最初の addrinfo 構造体 (構造体メンバーがポイントするバッファーを含む) を解放し、addrinfo 構造体の ai_next メンバーによってリンクされている addrinfo 構造体を解放し続けます。 freeaddrinfo 関数は、NULLai_next メンバーが検出されるまで、リンクされた構造体の解放を続行します。
Winsock ヘッダー ファイル内のマクロでは、 FreeAddrInfo の大文字と小文字が混在する関数名と ADDRINFOT 構造体を定義します。 この FreeAddrInfo 関数は、ADDRINFOT 型のポインターの ai パラメーターを使用して呼び出す必要があります。 UNICODE または_UNICODEが定義されていない場合、 FreeAddrInfo は freeaddrinfo に定義され、関数の ANSI バージョン、 ADDRINFOT は addrinfo 構造体に定義されます。 UNICODE または_UNICODEが定義されている場合、 FreeAddrInfo は FreeAddrInfoW に定義され、Unicode バージョンの関数は、 ADDRINFOT は addrinfoW 構造体に定義されます。
以前のバージョンの Windows での freeaddrinfo のサポート
freeaddrinfo 関数は、Windows XP 以降の Ws2_32.dll に追加されました。FreeAddrInfoW 関数は、freeaddrinfo の Unicode バージョンです。 FreeAddrInfoW 関数が Windows XP Service Pack 2 (SP2) の Ws2_32.dll に追加されました。 FreeAddrInfoW 関数は、SP2 を使用する Windows XP より前のバージョンの Windows では使用できません。
Windows Phone 8:freeaddrinfo 関数は、Windows Phone 8 以降のWindows Phone ストア アプリでサポートされています。
Windows 8.1およびWindows Server 2012 R2: freeaddrinfo 関数と FreeAddrInfoW 関数は、Windows 8.1、Windows Server 2012 R2 以降の Windows ストア アプリでサポートされています。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8.1、 Windows Vista [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2003 [デスクトップ アプリのみ | UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | ws2tcpip.h |
| [DLL] | Ws2_32.dll |