通过

IMcastLeaseInfo：：get_RequestID 方法 (mdhcp.h)

  • 项目

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

get_RequestID 方法获取租约的请求 ID。 此方法的主要用途是在应用程序退出后保存请求 ID，以便可以调用 IMcastAddressAllocation：：CreateLeaseInfo 在后续运行期间重新创建租约信息对象。 这使你可以在最初请求租约的程序实例退出后续订或释放租约。

语法

HRESULT get_RequestID(
  [out] BSTR *ppRequestID
);

parameters

[out] ppRequestID

指向将接收此租约的请求 ID 的 BSTR 的指针。 请求 ID 唯一标识向服务器发送的此租约请求。

返回值

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

返回代码 说明
S_OK
 方法成功。
S_FAIL
 租约信息对象包含无效的请求 ID。
E_POINTER
 传入无效指针参数的调用方。
E_OUTOFMEMORY
 内存不足，无法分配 BSTR。

注解

应用程序必须使用 SysFreeString 来释放为 ppRequestID 参数分配的内存。

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

要求

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

另请参阅

IMcastLeaseInfo