CreatePersistentUdpPortReservation

ローカルコンピュータで連続する UDP ポートブロックに対する永続的な UDP ポート予約を作成する。

CreatePersistentUdpPortReservation StartPort, NumberOfPorts, Token

StartPort : [int] ネットワークバイトオーダーでの開始 UDP ポート番号。
NumberOfPorts : [int] 予約する UDP ポート番号の個数。
Token : [var] 成功時に返されるポート予約トークンへのポインタ。

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

解説

ローカルコンピュータで連続する UDP ポートブロックに対する永続的な UDP ポート予約を作成する。

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

[備考]
CreatePersistentUdpPortReservation 関数は Windows Vista 以降で定義され、UDP
ポートブロックを永続的に予約する。使い方は TCP 版 (CreatePersistentTcpPortReservation)
とほぼ同じで、Windows の UDP モジュール用永続ストアに記録される。必要なポート数と範囲を指定し、成功すれば ULONG64
の不透明トークンが返される。解放は DeletePersistentUdpPortReservation
を呼ぶ。再起動するとトークンは変わりうる。永続予約にはコンポーネント間のセキュリティ制御はない。本関数は Administrators
グループのメンバーとしてログオンしたユーザーからのみ呼び出せる。Administrators グループのメンバーでないユーザーが呼び出すと
ERROR_ACCESS_DENIED を返して失敗する。Windows Vista 以降のユーザーアカウント制御 (UAC)
によっても失敗しうる。この関数を含むアプリケーションをビルトイン Administrator 以外の Administrators
グループのメンバーが実行した場合、マニフェストファイルで requestedExecutionLevel を
requireAdministrator に設定していない限りこの呼び出しは失敗する。マニフェストがない場合は、昇格シェル
(管理者として実行) から起動する必要がある。

情報