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

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

  • Статья

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

Метод 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

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

Эта функция может отправлять данные по сети в незашифрованном виде; Таким образом, кто-то прослушивает в сети, может быть в состоянии прочитать данные. Перед использованием этого метода следует учитывать риск безопасности при отправке данных в виде чистого текста.

Требования

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

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

IMcastAddressAllocation