共用方式為

IMcastAddressAllocation：：RequestAddress 方法 (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 提供類似的功能。]

RequestAddress方法會取得一或多個多播位址的新租用。 必須先呼叫 EnumerateScopes或get_Scopes方法。

語法

HRESULT RequestAddress(
  [in]  IMcastScope     *pScope,
  [in]  DATE            LeaseStartTime,
  [in]  DATE            LeaseStopTime,
  [in]  long            NumAddresses,
  [out] IMcastLeaseInfo **ppLeaseResponse
);

參數

[in] pScope

識別應用程式需要位址的多播範圍。 應用程式會先 呼叫 get_Scopes 或 EnumerateScopes ，以取得可用範圍的清單。

[in] LeaseStartTime

要求在這些位址上租用開始的時間。 實際授與的開始時間可能不同。

[in] LeaseStopTime

要求在這些位址上租用停止的時間。 實際授與的停止時間可能不同。

[in] NumAddresses

要求的位址數目。 實際上可能會授與較少的位址。

[out] ppLeaseResponse

要設定為指向新 IMcastLeaseInfo 物件的介面指標指標。 此介面接著可用來探索授與租用的實際屬性。 如需詳細資訊，請參閱 IMcastScope 。

傳回值

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

值 意義
S_OK
 方法成功。
E_POINTER
 傳入無效指標引數的呼叫端。
E_OUTOFMEMORY
 記憶體不足，無法建立必要的物件。
E_INVALIDARG
 要求的停止時間是在要求的停止時間之前。

備註

雖然這些 COM 介面及其實作支援一次配置多個位址，但基礎函式呼叫目前不支援多個配置。 您可能需要針對多個位址配置使用迴圈。

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

需求

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

另請參閱

IMcastAddressAllocation