NotifyStableUnicastIpAddressTable

ローカルコンピュータ上の安定したユニキャスト IP アドレステーブルを取得する。

NotifyStableUnicastIpAddressTable Family, Table, CallerCallback, CallerContext, NotificationHandle

Family : [int] 取得するアドレスファミリ。アドレスファミリの値は Winsock2.h で定義される。AF_ と PF_ の定数は等価 (例: AF_INET と PF_INET) である。Windows Vista 以降向け SDK では Ws2def.h で定義される。Ws2def.h は Winsock2.h から自動インクルードされるので直接使用してはならない。現在サポートされる値は AF_INET、AF_INET6、AF_UNSPEC である。
Table : [var] MIB_UNICASTIPADDRESS_TABLE 構造体へのポインタ。NotifyStableUnicastIpAddressTable が成功するとこのパラメータにローカルコンピュータの安定したユニキャスト IP アドレステーブルが返される。ERROR_IO_PENDING が返された場合は、テーブルは CallerCallback に渡される。
CallerCallback : [int] 安定したユニキャスト IP アドレステーブルを伴って呼び出される関数へのポインタ。NotifyStableUnicastIpAddressTable が ERROR_IO_PENDING (I/O 要求保留中) を返した場合に起動される。
CallerContext : [intptr] 安定したユニキャスト IP アドレステーブルが利用可能になったときに CallerCallback に渡されるユーザコンテキスト。
NotificationHandle : [intptr] 安定したユニキャスト IP アドレステーブル取得要求をキャンセルするのに使えるハンドルを返すためのポインタ。戻り値が ERROR_IO_PENDING (I/O 要求保留中) の場合にのみ返される。

(プラグイン / モジュール : iphlpapi.dll)

解説

ローカルコンピュータ上の安定したユニキャスト IP アドレステーブルを取得する。

[戻り値]
即座に成功した場合、戻り値は NO_ERROR となり Table にテーブルが返される。I/O 要求が保留の場合は
ERROR_IO_PENDING が返され、I/O 完了時に CallerCallback
が安定したテーブルを伴って呼び出される。失敗時は以下のエラーコードのいずれかが返される。
このドキュメントは省略されている。

[備考]
NotifyStableUnicastIpAddressTable 関数は Windows Vista
以降で定義される。即座に成功した場合は NO_ERROR を返し、Table に安定したユニキャスト IP
テーブルが返される。この場合、呼び出し元は FreeMibTable で Table
のメモリを解放する必要がある。dial-on-demand アドレスを除くすべてのユニキャスト IP アドレスは、preferred 状態
(MIB_UNICASTIPADDRESS_ROW の DadState が IpDadStatePreferred)
のときのみ安定と見なされる。各 dial-on-demand アドレスは独自の安定性メトリックを定義する。現在この関数が対象とする
dial-on-demand アドレスは Teredo クライアントのユニキャスト IP アドレスのみ。Family は
AF_INET、AF_INET6、AF_UNSPEC のいずれかに設定する必要がある。成功時は Table
にテーブルが返り、ERROR_IO_PENDING の場合は CallerCallback で後に返される。主に Teredo
クライアントを使うアプリケーションで使用される。Teredo アドレスが安定 (qualified) 状態でない場合、関数は
ERROR_IO_PENDING を返し、後で CallerCallback を介してテーブルが返される。Teredo
アドレスが不在、あるいは既に安定状態で他のすべても安定なら、コールバックは呼び出されない。コールバック関数は VOID
型で定義し、渡されるパラメータは次のとおり:
このドキュメントは省略されている。

情報