FreeAddrInfoW 関数 (ws2tcpip.h)

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

必要条件

要件	価値
サポートされる最小クライアント	Windows 8.1、Windows Vista [デスクトップ アプリ |UWP アプリ]
サポートされる最小サーバー	Windows Server 2003 [デスクトップ アプリ |UWP アプリ]
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	ws2tcpip.h
ライブラリ	Ws2_32.lib
DLL	Ws2_32.dll

関連項目

GetAddrInfoW の

Winsock Functions

addrinfo を する

addrinfoW を する

freeaddrinfo を する

getaddrinfo を する