lineGetAppPriority 函数 (tapi.h)

项目
08/26/2023

lineGetAppPriority 函数使应用程序能够确定它是否处于特定媒体模式或辅助电话请求模式的切换优先级列表中，如果是，则确定它在优先级列表中的位置。

语法

LONG lineGetAppPriority(
  LPCSTR            lpszAppFilename,
  DWORD             dwMediaMode,
  LPLINEEXTENSIONID lpExtensionID,
  DWORD             dwRequestMode,
  LPVARSTRING       lpExtensionName,
  LPDWORD           lpdwPriority
);

参数

lpszAppFilename

指向包含应用程序可执行模块文件名（不含目录数据）的字符串的指针。在 API 版本 2.0 或更高版本中，参数可以是长文件名格式，其中 8.3 文件名格式是适当的子集。与 8.3 文件名不同，长文件名保留大小写。这两种文件名格式都不区分大小写。有关详细信息，请参阅文件名约定。在低于 2.0 的 API 版本中，参数必须指定 8.3 格式的文件名;不能使用长文件名。

dwMediaMode

要为其获取优先级数据的媒体模式。该值可以是 LINEMEDIAMODE_常量之一;只能打开一个位。如果验证辅助电话请求的应用程序优先级，应使用值 0。

lpExtensionID

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

dwRequestMode

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

lpExtensionName

忽略此参数。

lpdwPriority

指向 DWORD 大小的内存位置的指针，TAPI 在其中写入指定媒体或请求模式的应用程序优先级。如果应用程序不在存储的优先级列表中，并且当前未打开任何行设备，并且请求指定媒体模式的所有权或已注册指定请求模式，则返回值 0。

在低于 2.0 的 API 版本中，如果应用程序为指定的媒体模式打开行或已注册指定请求，但应用程序不在存储的优先级列表中，则返回值 –1 (0xFFFFFFFF) ;也就是说，它仅位于临时优先级列表中。在 API 版本 2.0 或更高版本中，返回值 0 以指示这种情况。

否则，值指示应用程序在列表中的位置;1 表示最高优先级，并递增表示优先级降低的值。

返回值

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

LINEERR_INIFILECORRUPT、LINEERR_INVALREQUESTMODE、LINEERR_INVALAPPNAME、LINEERR_NOMEM、LINEERR_INVALMEDIAMODE、LINEERR_OPERATIONFAILED、LINEERR_INVALPOINTER、LINEERR_STRUCTURETOOSMALL。