通过

IMcastAddressAllocation：：CreateLeaseInfoFromVariant 方法 (mdhcp.h)

  • 项目

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

CreateLeaseInfoFromVariant 方法为后续调用 RenewAddress 或 ReleaseAddress 创建租约信息对象。 此方法类似于 CreateLeaseInfo ，但由自动化客户端语言（如 Visual Basic）使用。

语法

HRESULT CreateLeaseInfoFromVariant(
  [in]  DATE            LeaseStartTime,
  [in]  DATE            LeaseStopTime,
  [in]  VARIANT         vAddresses,
  [in]  BSTR            pRequestID,
  [in]  BSTR            pServerAddress,
  [out] IMcastLeaseInfo **ppReleaseRequest
);

parameters

[in] LeaseStartTime

租约的开始时间。

[in] LeaseStopTime

租约的停止时间。

[in] vAddresses

包含 BSTR 字符串的 SAFEARRAY 的 VARIANT。 每个 BSTR 都是一个 IP 版本 4 地址，以点四表示法 (例如 10.111.222.111) 。

[in] pRequestID

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

[in] pServerAddress

指向指定服务器地址的 BSTR 的指针。

[out] ppReleaseRequest

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

返回值

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

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

注解

应用程序必须使用 SysAllocString 为 pRequestID 和 pServerAddress 参数分配内存。 当不再需要变量时，应用程序必须使用 SysFreeString 来释放内存。

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

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

要求

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

另请参阅

IMcastAddressAllocation

IMcastLeaseInfo