IH323LineEx::SetDefaultCapabilityPreferrence 方法

[SetDefaultCapabilityPreferrence 不适用于 Windows Vista、Windows Server 2008 和操作系统的后续版本。 RTC 客户端 API 提供类似的功能。]

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,或者 pCapabilitiespWeights 均为 NULL,或者 pCapabilities 数组包含无效的 H.245 功能对象。
E_POINTER
无法读取 pWeights 数组的元素或 pCapabilities 数组的元素。

要求

要求
TAPI 版本
需要 TAPI 3.0 或更高版本
标头
H323priv.h

Uuid.lib
DLL
Tapi3.dll