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

Метод IMcastLeaseInfo::get_RequestID (mdhcp.h)

  • Статья

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

Метод get_RequestID получает идентификатор запроса для аренды. Основная цель этого метода — позволить сохранить идентификатор запроса после завершения работы приложения, чтобы можно было вызвать IMcastAddressAllocation::CreateLeaseInfo для повторного создания объекта сведений об аренде во время последующего выполнения. Это позволяет продлить или освободить аренду после завершения работы экземпляра программы, который первоначально запросил аренду.

Синтаксис

HRESULT get_RequestID(
  [out] BSTR *ppRequestID
);

Параметры

[out] ppRequestID

Указатель на BSTR , который получит идентификатор запроса для этой аренды. Идентификатор запроса однозначно идентифицирует этот запрос на аренду к серверу.

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Код возврата Описание
S_OK
 Метод успешно выполнен.
S_FAIL
 Объект сведений об аренде содержит недопустимый идентификатор запроса.
E_POINTER
 Вызывающий объект передал недопустимый аргумент указателя.
E_OUTOFMEMORY
 Недостаточно памяти для выделения BSTR.

Комментарии

Приложение должно использовать SysFreeString для освобождения памяти, выделенной для параметра ppRequestID .

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

Требования

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

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

IMcastLeaseInfo