共用方式為

IMcastAddressAllocation：：CreateLeaseInfoFromVariant 方法 (mdhcp.h)

  • 發行項

[Rendezvous IP Telephony 會議控制項和介面不適用於 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
);

參數

[in] LeaseStartTime

租用的開始時間。

[in] LeaseStopTime

租用的停止時間。

[in] vAddresses

VARIANT，其中包含BSTR字串的 SAFEARRAY。 每個 BSTR 都是虛線四次標記法中的 IP 第 4 版位址 (，例如 10.111.222.111) 。

[in] pRequestID

BSTR的指標，指定原始要求的要求識別碼。 這是藉由呼叫對應至原始要求的租用資訊物件上的 IMcastLeaseInfo：：get_RequestID 來取得。 要求識別碼應該儲存在應用程式程式執行之間的永續性儲存體中。 如果您要更新或釋放在相同應用程式執行期間要求的租用，您就沒有理由使用 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
程式庫 Uuid.lib
Dll Mdhcp.dll

另請參閱

IMcastAddressAllocation

IMcastLeaseInfo