共用方式為

IMcastAddressAllocation：：CreateLeaseInfo 方法 (mdhcp.h)

  • 發行項

[Rendezvous IP Telephony Conferencing controls and interface not available for use in Windows Vista， Windows Server 2008， and subsequent versions of the operating system. RTC 用戶端 API 提供類似的功能。]

CreateLeaseInfo方法會為後續呼叫 RenewAddress 或 ReleaseAddress建立租用資訊物件。

語法

HRESULT CreateLeaseInfo(
  [in]  DATE            LeaseStartTime,
  [in]  DATE            LeaseStopTime,
  [in]  DWORD           dwNumAddresses,
  [in]  LPWSTR          *ppAddresses,
  [in]  LPWSTR          pRequestID,
  [in]  LPWSTR          pServerAddress,
  [out] IMcastLeaseInfo **ppReleaseRequest
);

參數

[in] LeaseStartTime

租用的開始時間。

[in] LeaseStopTime

租用的停止時間。

[in] dwNumAddresses

與租用相關聯的位址數目。

[in] ppAddresses

大小dwNumAddresses的LPWSTR指標陣列。 每個 LPWSTR 都是虛線四邊形標記法中的 IP 第 4 版位址 (，例如 10.111.222.111) 。

[in] pRequestID

LPWSTR，指定原始要求的要求識別碼。 這是藉由呼叫對應至原始要求的租用資訊物件 上的 IMcastLeaseInfo：：get_RequestID 來取得。 要求識別碼應該儲存在應用程式程式執行之間的永續性儲存體中。 如果您要更新或釋放在相同應用程式執行期間要求的租用，則您沒有理由使用 CreateLeaseInfo;只要將現有的 IMcastLeaseInfo 指標傳遞至 RenewAddress 或 ReleaseAddress即可。

[in] pServerAddress

指定伺服器位址。

[out] ppReleaseRequest

建立 之 IMcastLeaseInfo 介面的指標。

傳回值

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

值 意義
S_OK
 方法成功。
E_POINTER
 傳入無效指標引數的呼叫端。
E_OUTOFMEMORY
 記憶體不足，無法建立必要的物件。

備註

TAPI 會在IMcastAddressAllocation：：CreateLeaseInfo所傳回的IMcastLeaseInfo介面上呼叫AddRef方法。 應用程式必須在IMcastLeaseInfo介面上呼叫Release，以釋放與其相關聯的資源。

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

需求

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

另請參閱

IMcastAddressAllocation