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]
-
与功能关联的权重数组。
返回值
此方法可以返回其中一个值。
返回代码 | 说明 |
---|---|
|
方法成功。 |
|
内存不足,无法执行操作。 |
|
pCapabilities 参数为 NULL,或 pWeights 参数为 NULL,或者 pCapabilities 和 pWeights 均为 NULL,或者 pCapabilities 数组包含无效的 H.245 功能对象。 |
|
无法读取 pWeights 数组的元素或 pCapabilities 数组的元素。 |
要求
要求 | 值 |
---|---|
TAPI 版本 |
需要 TAPI 3.0 或更高版本 |
标头 |
|
库 |
|
DLL |
|