IMcastAddressAllocation：：RequestAddress 方法 (mdhcp.h)

[会合 IP 电话会议控件和接口不适用于 Windows Vista、Windows Server 2008 和操作系统的后续版本。 RTC 客户端 API 提供类似的功能。]

RequestAddress 方法获取一个或多个多播地址的新租约。 必须先调用 EnumerateScopes 或 get_Scopes 方法。

语法

HRESULT RequestAddress(
  [in]  IMcastScope     *pScope,
  [in]  DATE            LeaseStartTime,
  [in]  DATE            LeaseStopTime,
  [in]  long            NumAddresses,
  [out] IMcastLeaseInfo **ppLeaseResponse
);

parameters

[in] pScope

标识应用程序需要地址的多播范围。 应用程序首先调用 get_Scopes 或 EnumerateScopes 以获取可用范围的列表。

[in] LeaseStartTime

请求这些地址的租约开始时间。 实际授予的开始时间可能不同。

[in] LeaseStopTime

请求停止这些地址的租约的时间。 实际授予的停止时间可能不同。

[in] NumAddresses

请求的地址数。 实际可能授予的地址更少。

[out] ppLeaseResponse

指向接口指针的指针，该指针将设置为指向新的 IMcastLeaseInfo 对象。 然后，可以使用此接口来发现授予的租约的实际属性。 有关详细信息，请参阅 IMcastScope 。

返回值

此方法可以返回其中一个值。

注解

尽管这些 COM 接口及其实现支持一次分配多个地址，但基础函数调用目前不支持多个分配。 可能需要使用循环进行多个地址分配。

TAPI 在 IMcastAddressAllocation：：RequestAddress 返回的 IMcastLeaseInfo 接口上调用 AddRef 方法。 应用程序必须在 IMcastLeaseInfo 接口上调用 Release，以释放与之关联的资源。

要求

另请参阅

IMcastAddressAllocation