ITTAPI：：SetApplicationPriority 方法 (tapi3if.h)

SetApplicationPriority 方法允许应用程序在特定媒体类型或辅助电话请求模式的切换优先级列表中设置其优先级，或者从优先级列表中删除自身。

语法

HRESULT SetApplicationPriority(
  [in] BSTR         pAppFilename,
  [in] long         lMediaType,
  [in] VARIANT_BOOL fPriority
);

参数

[in] pAppFilename

指向包含应用程序名称的 BSTR 的指针。

[in] lMediaType

与应用程序关联的媒体。

[in] fPriority

应用程序的新优先级。 如果传递了VARIANT_FALSE的值，则会将应用程序从指定媒体或请求模式的优先级列表中删除 (如果尚不存在，则不会) 生成错误。 如果传递了VARIANT_TRUE值，则会将应用程序作为媒体或请求模式的最高优先级应用程序插入 (，并从优先级较低的位置删除（如果它已在列表中) ）。

返回值

此方法可以返回其中一个值。

返回代码	说明
S_OK	方法成功。
E_OUTOFMEMORY	内存不足，无法执行操作。

注解

应用程序必须使用 SysAllocString 为 pAppFilename 参数分配内存，并在不再需要变量时使用 SysFreeString 释放内存。

使用 SetApplicationPriority 设置的优先级将在系统重启或 tapisrv 重启后保留。 ITTAPI：：RegisterCallNotifications 函数打开没有指定调用优先级的行。 默认情况下，优先级最高的应用程序将是首先调用 ITTAPI：：RegisterCallNotifications 的应用程序。

要求

要求	值
目标平台	Windows
标头	tapi3if.h (包括 Tapi3.h)
Library	Uuid.lib
DLL	Tapi3.dll

另请参阅

ITBasicCallControl：：HandoffIndirect

ITTAPI

TAPI 对象