lineGetAppPriorityW 函数（tapi.h）

2024-11-20

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

语法

LONG lineGetAppPriorityW(
  LPCWSTR           lpszAppFilename,
  DWORD             dwMediaMode,
  LPLINEEXTENSIONID lpExtensionID,
  DWORD             dwRequestMode,
  LPVARSTRING       lpExtensionName,
  LPDWORD           lpdwPriority
);

参数

lpszAppFilename

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

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。