void NET_UnrefAddress(NET_Address *address);
| NET_Address * | address | 参照を切り離すNET_Address |
1つのNET_Addressは, 解決の処理を行う背後のスレッドなどのライブラリの様々な箇所で共有しているため, このオブジェクトは参照カウントしている. そのため, どこでも必要ならば使用するために宣言することができ, 不要になればアドレスへの参照をどこでも切り離すことができる. オブジェクトの資源は参照の最後の切り離しで解放される.
この関数はNET_Addressの参照を切り離し, 参照カウンタを1減らす.
ドキュメントには, いつアプリケーションが明示的にアドレスへの参照を切り離さなければならないかが記述されている. 例えば, NET_ResolveHostname()は既に参照されているアドレスを生成するため, 呼び出し側は不要になれば参照を切り離す必要がある.
この関数はどのスレッドからも安全に呼べる.