LookupPersistentTcpPortReservation

ローカルコンピュータ上の連続する TCP ポートブロックに対する永続的な TCP ポート予約のトークンを検索する。

LookupPersistentTcpPortReservation StartPort, NumberOfPorts, Token

StartPort : [int] ネットワークバイト順での開始 TCP ポート番号。
NumberOfPorts : [int] 予約されていた TCP ポート番号の数。
Token : [var] 関数が成功した場合に返されるポート予約トークンへのポインタ。

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

解説

ローカルコンピュータ上の連続する TCP ポートブロックに対する永続的な TCP ポート予約のトークンを検索する。

[戻り値]
関数が成功すると、戻り値は NO_ERROR である。失敗した場合は以下のエラーコードのいずれかが返される。
このドキュメントは省略されている。

[備考]
LookupPersistentTcpPortReservation 関数は Windows Vista 以降で定義される。TCP
ポートのブロックに対する永続的な予約のトークンを検索する。TCP ポートブロックに対する永続的な予約は
CreatePersistentTcpPortReservation 関数の呼び出しによって作成される。この関数に渡される
StartPort / NumberOfPorts は、CreatePersistentTcpPortReservation
で予約作成時に使用した値と一致しなければならない。関数が成功すると、Token パラメータには TCP
ポートブロックの永続的な予約トークンが返される。ある永続的予約のトークンは、システム再起動のたびに変更されることがある点に注意する。
アプリケーションは TCP ソケットをオープンし、bind を呼び出す前に WSAIoctl で
SIO_ASSOCIATE_PORT_RESERVATION IOCTL と予約トークンを渡すことで、TCP
ポート予約からのポート割り当てを要求できる。

情報