Поделиться через

Метод IMcastAddressAllocation::RequestAddress (mdhcp.h)

  • Статья

[Элементы управления и интерфейсы конференц-связи с IP-телефонией рандеву недоступны для использования в Windows Vista, Windows Server 2008 и последующих версиях операционной системы. Api клиента RTC предоставляет аналогичные функциональные возможности.]

Метод 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 вызывает метод AddRef в интерфейсе IMcastLeaseInfo , возвращенном методом IMcastAddressAllocation::RequestAddress. Приложение должно вызвать Release в интерфейсе IMcastLeaseInfo , чтобы освободить связанные с ним ресурсы.

Требования

   
Целевая платформа Windows
Header mdhcp.h
Библиотека Uuid.lib
DLL Mdhcp.dll

См. также раздел

IMcastAddressAllocation