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 指標。 要求識別碼可唯一識別伺服器的此租用要求。
傳回值
這個方法可以傳回其中一個值。
傳回碼 | 描述 |
---|---|
|
方法成功。 |
|
租用資訊物件包含不正確要求識別碼。 |
|
傳入無效指標引數的呼叫端。 |
|
記憶體不足,無法配置 BSTR。 |
備註
應用程式必須使用 SysFreeString 來釋放配置給 ppRequestID 參數的記憶體。
此函式可能會以未加密的形式透過網路傳送資料;因此,網路上有人竊聽可能會讀取資料。 使用此方法之前,應該考慮以純文字傳送資料的安全性風險。
需求
目標平台 | Windows |
標頭 | mdhcp.h |
程式庫 | Uuid.lib |
Dll | Mdhcp.dll |