共用方式為


IMcastLeaseInfo::get_RequestID 方法 (mdhcp.h)

[Rendezvous IP Telephony 會議控制項和介面不適用於 Windows Vista、Windows Server 2008 和後續版本的作業系統。 RTC 用戶端 API 提供類似的功能。

get_RequestID方法會取得租用的要求識別碼。 此方法的主要用途是在應用程式結束時儲存要求識別碼,以便您可以在後續執行期間呼叫 IMcastAddressAllocation::CreateLeaseInfo 來重新建立租用資訊物件。 這可讓您在原本要求租用的程式實例結束之後,更新或釋放租用。

語法

HRESULT get_RequestID(
  [out] BSTR *ppRequestID
);

參數

[out] ppRequestID

將接收此租用要求識別碼的 BSTR 指標。 要求識別碼可唯一識別伺服器的此租用要求。

傳回值

這個方法可以傳回其中一個值。

傳回碼 描述
S_OK
方法成功。
S_FAIL
租用資訊物件包含不正確要求識別碼。
E_POINTER
傳入無效指標引數的呼叫端。
E_OUTOFMEMORY
記憶體不足,無法配置 BSTR

備註

應用程式必須使用 SysFreeString 來釋放配置給 ppRequestID 參數的記憶體。

此函式可能會以未加密的形式透過網路傳送資料;因此,網路上有人竊聽可能會讀取資料。 使用此方法之前,應該考慮以純文字傳送資料的安全性風險。

需求

   
目標平台 Windows
標頭 mdhcp.h
程式庫 Uuid.lib
Dll Mdhcp.dll

另請參閱

IMcastLeaseInfo