Метод IMcastAddressAllocation::CreateLeaseInfoFromVariant (mdhcp.h)
[Элементы управления и интерфейсы конференц-связи с IP-телефонией для встреч недоступны для использования в Windows Vista, Windows Server 2008 и последующих версиях операционной системы. Api клиента RTC предоставляет аналогичные функции.]
Метод 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, содержащий SAFEARRAY строк BSTR. Каждый адрес BSTR является IP-адресом версии 4 в пунктирной четырехугольной нотации (например, 10.111.222.111).
[in] pRequestID
Указатель на BSTR , указывающий идентификатор запроса для исходного запроса. Это получается путем вызова IMcastLeaseInfo::get_RequestID объекта сведений об аренде, соответствующего исходному запросу. Идентификатор запроса должен сохраняться в постоянном хранилище между выполнением программы приложения. При продлении или освобождении аренды, запрошенной во время того же запуска приложения, у вас нет причин использовать CreateLeaseInfo; просто передайте существующий указатель IMcastLeaseInfo в пункт RenewAddress или ReleaseAddress.
[in] pServerAddress
Указатель на BSTR , указывающий адрес сервера.
[out] ppReleaseRequest
Указатель на созданный интерфейс IMcastLeaseInfo .
Возвращаемое значение
Этот метод может возвращать одно из этих значений.
Значение | Значение |
---|---|
|
Метод успешно выполнен. |
|
Вызывающий объект передает недопустимый аргумент указателя. |
|
Недостаточно памяти для создания необходимых объектов. |
Комментарии
Приложение должно использовать SysAllocString для выделения памяти для параметров pRequestID и pServerAddress . Приложение должно использовать SysFreeString , чтобы освободить память, когда переменные больше не нужны.
TAPI вызывает метод AddRef в интерфейсе IMcastLeaseInfo , возвращенном методом IMcastAddressAllocation::CreateLeaseInfoFromVariant. Приложение должно вызывать Release в интерфейсе IMcastLeaseInfo , чтобы освободить связанные с ним ресурсы.
Эта функция может отправлять данные по сети в незашифрованном виде; Таким образом, кто-то прослушивает в сети, может быть в состоянии прочитать данные. Перед использованием этого метода следует учитывать риск безопасности при отправке данных в виде чистого текста.
Требования
Целевая платформа | Windows |
Header | mdhcp.h |
Библиотека | Uuid.lib |
DLL | Mdhcp.dll |