通过

IMcastAddressAllocation：：CreateLeaseInfo 方法 (mdhcp.h)

  • 项目

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

CreateLeaseInfo 方法为后续调用 RenewAddress 或 ReleaseAddress 创建租约信息对象。

语法

HRESULT CreateLeaseInfo(
  [in]  DATE            LeaseStartTime,
  [in]  DATE            LeaseStopTime,
  [in]  DWORD           dwNumAddresses,
  [in]  LPWSTR          *ppAddresses,
  [in]  LPWSTR          pRequestID,
  [in]  LPWSTR          pServerAddress,
  [out] IMcastLeaseInfo **ppReleaseRequest
);

parameters

[in] LeaseStartTime

租约的开始时间。

[in] LeaseStopTime

租约的停止时间。

[in] dwNumAddresses

与租约关联的地址数。

[in] ppAddresses

大小为 dwNumAddresses 的 LPWSTR 指针数组。 每个 LPWSTR 都是一个 IP 版本 4 地址，以虚四边形表示法 (例如 10.111.222.111) 。

[in] pRequestID

指定原始请求的请求 ID 的 LPWSTR 。 这是通过在与原始请求对应的租约信息对象上调用 IMcastLeaseInfo：：get_RequestID 获取的。 请求 ID 应保存在应用程序执行之间的持久存储中。 如果要续订或释放在同一运行应用程序期间请求的租约，则没有理由使用 CreateLeaseInfo;只需将现有 IMcastLeaseInfo 指针传递给 RenewAddress 或 ReleaseAddress 即可。

[in] pServerAddress

指定服务器地址。

[out] ppReleaseRequest

指向创建的 IMcastLeaseInfo 接口的指针。

返回值

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

值 含义
S_OK
 方法成功。
E_POINTER
 传入无效指针参数的调用方。
E_OUTOFMEMORY
 内存不足，无法创建所需的对象。

注解

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

此函数可能以未加密的形式通过网络发送数据;因此，在网络上窃听的人可能能够读取数据。 使用此方法之前，应考虑以明文形式发送数据的安全风险。

要求

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

另请参阅

IMcastAddressAllocation