MCAST_LEASE_REQUEST结构定义给定多播范围的请求、续订或发布参数。 在MCAST_API_VERSION_1实现中,一次只能分配一个 IP 地址。
语法
typedef struct _MCAST_LEASE_REQUEST {
LONG LeaseStartTime;
LONG MaxLeaseStartTime;
DWORD LeaseDuration;
DWORD MinLeaseDuration;
IPNG_ADDRESS ServerAddress;
WORD MinAddrCount;
WORD AddrCount;
PBYTE pAddrBuf;
} MCAST_LEASE_REQUEST, *PMCAST_LEASE_REQUEST;
成员
LeaseStartTime
自 1970 年 1 月 1 日午夜起多播范围租约的请求开始时间(以秒为单位),协调世界时。 若要请求当前时间作为租用开始时间,请将 LeaseStartTime 设置为零。
MaxLeaseStartTime
客户愿意接受的自 1970 年 1 月 1 日午夜以来的最长开始时间(以秒为单位)。
LeaseDuration
租约请求的持续时间(以秒为单位)。 若要请求默认租用持续时间,请将 LeaseDuration 和 MinLeaseDuration 设置为零。
MinLeaseDuration
客户端愿意接受的最短租约持续时间(以秒为单位)。
ServerAddress
Internet 协议 (请求或续订租约的服务器的 IP) 地址,采用 IPNG_ADDRESS 结构的形式。 如果服务器的 IP 地址未知(例如在 McastRequestAddress 函数调用中使用此结构时),请将 ServerAddress 设置为零。
MinAddrCount
客户端愿意接受的最小 IP 地址数。
AddrCount
请求的 IP 地址数。 请注意,此成员的值决定了 pAddrBuf 的大小。
pAddrBuf
指向包含所请求 IP 地址的缓冲区的指针。 对于 IPv4 地址, pAddrBuf 成员指向 4 字节地址;对于 IPv6 地址, pAddrBuf 成员指向 16 字节地址。 如果未请求任何特定地址,请将 pAddrBuf 设置为 NULL。
注解
在MCAST_API_VERSION_1版本中, 将忽略 MaxLeaseStartTime、 MinLeaseDuration 和 MinAddrCount 成员。 但是,客户端仍应为这些成员设置适当的值,以便在将来的更新中利用其实现。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
标头 | madcapcl.h |