lineSetAppPriority 函数使应用程序能够在特定媒体类型或辅助电话请求模式的交接优先级列表中设置其优先级，或从优先级列表中删除自身。
语法
LONG lineSetAppPriorityA(
LPCSTR lpszAppFilename,
DWORD dwMediaMode,
LPLINEEXTENSIONID lpExtensionID,
DWORD dwRequestMode,
LPCSTR lpszExtensionName,
DWORD dwPriority
);
参数
lpszAppFilename
指向包含应用程序可执行模块文件名的字符串的指针，不包含目录数据。 在 TAPI 版本 2.0 或更高版本中，参数可以指定长度或 8.3 文件名格式的文件名。
dwMediaMode
要为其设置应用程序的优先级的媒体类型。 该值可以是一个或多个 LINEMEDIAMODE 常量。 值零应用于设置辅助电话请求的应用程序优先级。
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的应用程序。
注意
tapi.h 标头将 lineSetAppPriority 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的
要求
| 要求 | 价值 |
|---|---|
| 目标平台 | 窗户 |
| 标头 | tapi.h |
| 库 | Tapi32.lib |
| DLL | Tapi32.dll |