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

Метод IH323LineEx::SetDefaultCapabilityPreferrence

  • Статья

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

Метод SetDefaultCapabilityPreferrence настраивает предпочтения возможностей по умолчанию. Вес возможностей по умолчанию — 100. Если приложение указывает более высокий вес для возможности, оно будет иметь более высокий приоритет во время согласования H.245. Если приложение устанавливает вес возможности в значение 0, оно не будет использоваться в согласовании H.245.

Этот метод является накопительным. Например, если этот метод вызывается сначала для отключения возможности и вызывается снова для отключения другой, обе возможности будут отключены в результате этих двух вызовов.

Синтаксис

HRESULT SetDefaultCapabilityPreferrence(
  [in] DWORD           dwNumCaps,
  [in] H245_CAPABILITY *pCapabilities,
  [in] DWORD           *pWeights
);

Параметры

dwNumCaps [in]

Значение DWORD , содержащее количество возможностей, заданных этим методом.

pCapabilities [in]

Массив возможностей. Каждый элемент массива является H245_CAPABILITY значением.

pWeights [in]

Массив весов, связанных с возможностями.

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

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

Код возврата Описание
S_OK
 Метод успешно выполнен.
E_OUTOFMEMORY
 Для выполнения операции недостаточно памяти.
E_INVALIDARG
 Параметр pCapabilities имеет значение NULL, параметр pWeights имеет значение NULL, либо оба значения pCapabilities и pWeights имеют значение NULL, либо массив pCapabilities содержит недопустимый объект возможности H.245.
E_POINTER
 Не удается прочитать элемент массива pWeights или элемент массива pCapabilities .

Требования

Требование Значение
Версия TAPI
 Требуется TAPI 3.0 или более поздней версии
Заголовок
H323priv.h
Библиотека
Uuid.lib
DLL
Tapi3.dll