lineSetAppPriority 函数 (tapi.h)

lineSetAppPriority 函数使应用程序能够在特定媒体类型或辅助电话请求模式的移交优先级列表中设置其优先级，或者从优先级列表中删除自身。

语法

LONG lineSetAppPriority(
  LPCSTR            lpszAppFilename,
  DWORD             dwMediaMode,
  LPLINEEXTENSIONID lpExtensionID,
  DWORD             dwRequestMode,
  LPCSTR            lpszExtensionName,
  DWORD             dwPriority
);

参数

lpszAppFilename

指向包含应用程序可执行模块文件名（不含目录数据）的字符串的指针。 在 TAPI 版本 2.0 或更高版本中， 参数可以指定长文件名或 8.3 文件名格式。

dwMediaMode

要为其设置应用程序优先级的媒体类型。 该值可以是一个或多个 LINEMEDIAMODE 常量。 值 0 应用于设置辅助电话请求的应用程序优先级。

lpExtensionID

指向 LINEEXTENSIONID 类型的结构的指针。 忽略此参数。

dwRequestMode

此参数的条件是，如果 dwMediaMode 参数为零，则此参数指定要为其设置优先级的辅助电话请求模式。 它必须LINEREQUESTMODE_MAKECALL。 如果 dwMediaMode 为非零值，则忽略此参数。

lpszExtensionName

忽略此参数。

dwPriority

一个参数，指示应用程序的新优先级。 如果传递值 0，则从指定媒体或请求模式的优先级列表中删除应用程序;如果尚不存在，则不会生成任何错误。 如果传递值 1，则会将应用程序插入为媒体或请求模式的最高优先级应用程序;如果已在列表中，则会将其从低优先级位置中删除。 任何其他值都会生成错误。

返回值

如果请求成功，则返回零;如果发生错误，则返回负错误号。 可能的返回值为：

LINEERR_INIFILECORRUPT、LINEERR_INVALREQUESTMODE、LINEERR_INVALAPPNAME、LINEERR_NOMEM、LINEERR_INVALMEDIAMODE、LINEERR_OPERATIONFAILED、LINEERR_INVALPARAM、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALPOINTER。

注解

如果返回 LINEERR_INVALMEDIAMODE ，则 dwMediaMode 中指定的值不是零，也不是 LINEMEDIAMODE_常量之一。

此函数更新存储的优先级列表。 如果电话系统已初始化，它还会为随后运行的应用程序设置当前活动优先级;新优先级用于下一个传入呼叫或 lineHandoff ，具体取决于媒体类型。

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

要求

要求	值
目标平台	Windows
标头	tapi.h
Library	Tapi32.lib
DLL	Tapi32.dll

另请参阅

LINEEXTENSIONID

补充线路服务函数

TAPI 2.2 参考概述

lineHandoff