NET_Address **SDLCALL NET_GetLocalAddresses(int *num_addresses);
| int * | num_addresses | この関数から戻ったときアドレスの数がここに代入される. NULLも可 |
この関数は, 別マシンからの接続を受け入れるために, ソケットに理論的にはバインドできるアドレスの一覧を戻す.
ほとんどの場合, この関数は必要ない. 第1に, ユーザに選択させずにどのアドレスにバインドするのがよいかを知ることは難しい(同様にユーザにも難しい). 第2に, ほとんどにはマシンは多くの同じLAN上の受け入れられるプライベートアドレスがあるが, 外部のインターネットから受け入れられるパブリックなアドレスではない.
通常は, NET_CreateServer()またはNET_CreateDatagramSocket()にNULLアドレスを渡して「全てのインターフェースをバインドする」方がよい.
この関数が戻したアドレスの配列はNULL終端であることが保証されている. さらに引数として配列の終端のNULLを含まないアドレス数が代入されるintポインタを渡すことができる.
戻された配列が不要になればNET_FreeLocalAddressesに渡し解放すること. 解放した後でも, この配列から得たアドレスはNET_RefAddress()を呼んでいれば使用できる.
この関数はどのスレッドからも安全に呼べる.