FreeAddrInfoW 関数 (ws2tcpip.h)

[アーティクル]
03/13/2024

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

構文

VOID WSAAPI FreeAddrInfoW(
  [in] PADDRINFOW pAddrInfo
);

パラメーター

[in] pAddrInfo

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

戻り値

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

注釈

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

Winsock ヘッダーファイル内のマクロでは、 FreeAddrInfo の大文字と小文字が混在する関数名と ADDRINFOT 構造体を定義します。この FreeAddrInfo 関数は、ADDRINFOT 型のポインターの pAddrInfo パラメーターを使用して呼び出す必要があります。 UNICODE または_UNICODEが定義されている場合、 FreeAddrInfo は FreeAddrInfoW に定義され、Unicode バージョンの関数は、 ADDRINFOT は addrinfoW 構造体に定義されます。 UNICODE または_UNICODEが定義されていない場合、 FreeAddrInfo は freeaddrinfo に定義され、関数の ANSI バージョン、 ADDRINFOT は addrinfo 構造体に定義されます。

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

注意

ws2tcpip.h ヘッダーは、FreeAddrInfo をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 8.1、 Windows Vista [デスクトップアプリ \|UWP アプリ]
サポートされている最小のサーバー	Windows Server 2003 [デスクトップアプリのみ \| UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	ws2tcpip.h
Library	Ws2_32.lib
[DLL]	Ws2_32.dll