MCAST_LEASE_REQUEST结构 (madcapcl.h)

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

租约请求的持续时间(以秒为单位)。 若要请求默认租用持续时间,请将 LeaseDurationMinLeaseDuration 设置为零。

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版本中, 将忽略 MaxLeaseStartTimeMinLeaseDurationMinAddrCount 成员。 但是,客户端仍应为这些成员设置适当的值,以便在将来的更新中利用其实现。

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
标头 madcapcl.h

另请参阅

IPNG_ADDRESS

MCAST_CLIENT_UID

MCAST_LEASE_RESPONSE

MCAST_SCOPE_CTX

MCAST_SCOPE_ENTRY

McastApiCleanup

McastApiStartup

McastEnumerateScopes

McastGenUID

McastRequestAddress