IMcastAddressAllocation::RequestAddress 方法 (mdhcp.h)

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

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

语法

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

parameters

[in] pScope

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

[in] LeaseStartTime

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

[in] LeaseStopTime

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

[in] NumAddresses

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

[out] ppLeaseResponse

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

返回值

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

含义
S_OK
方法成功。
E_POINTER
传入无效指针参数的调用方。
E_OUTOFMEMORY
内存不足,无法创建所需的对象。
E_INVALIDARG
请求的停止时间早于请求的停止时间。

注解

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

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

要求

   
目标平台 Windows
标头 mdhcp.h
Library Uuid.lib
DLL Mdhcp.dll

另请参阅

IMcastAddressAllocation