lookupPersistentUdpPortReservation 函数 (iphlpapi.h)

项目
03/05/2024

LookupPersistentUdpPortReservation 函数为本地计算机上 TCP 端口的连续块查找持久 UDP 端口预留的令牌。

语法

IPHLPAPI_DLL_LINKAGE ULONG LookupPersistentUdpPortReservation(
  [in]  USHORT   StartPort,
  [in]  USHORT   NumberOfPorts,
  [out] PULONG64 Token
);

参数

[in] StartPort

按网络字节顺序排列的起始 UDP 端口号。

[in] NumberOfPorts

保留的 UDP 端口号数。

[out] Token

指向在函数成功时返回的端口预留令牌的指针。

返回值

如果函数成功，则返回值NO_ERROR。

如果函数失败，则返回值为以下错误代码之一。

返回代码	说明
ERROR_INVALID_PARAMETER	向该函数传递了无效参数。如果在 StartPort 或NumberOfPorts 参数中传递零，则返回此错误。
ERROR_NOT_FOUND	找不到该元素。如果找不到由 StartPort 和 NumberOfPorts 参数指定的永久性端口块，则返回此错误。
其他	使用 FormatMessage 获取返回错误的消息字符串。

注解

LookupPersistentUdpPortReservation 函数在 Windows Vista 及更高版本上定义。

LookupPersistentUdpPortReservation 函数用于查找 UDP 端口块的持久预留的令牌。

UDP 端口块的持久保留是通过调用 CreatePersistentUdpPortReservation 函数创建的。传递给 LookupPersistentUdpPortReservation 函数的 StartPort 或 NumberOfPorts 参数必须与 CreatePersistentUdpPortReservation 函数创建 TCP 端口块的永久性预留时使用的值匹配。

如果 LookupPersistentUdpPortReservation 函数成功，则返回的 Token 参数将指向 UDP 端口块的持久端口预留的令牌。请注意，每次重新启动系统时，TCP 端口块的给定永久性预留的令牌可能会更改。

应用程序可以通过打开 UDP 套接字，然后调用 WSAIoctl 函数以指定 SIO_ASSOCIATE_PORT_RESERVATION IOCTL 并传递预留令牌，然后向套接字上的绑定函数发出调用来请求端口分配。

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
目标平台	Windows
标头	iphlpapi.h
Library	Iphlpapi.lib
DLL	Iphlpapi.dll