freeaddrinfo 関数 (ws2tcpip.h)

[アーティクル]
08/28/2023

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