lineSetAppPriority 函式可讓應用程式在特定媒體類型或輔助電話語音要求模式的交接優先順序清單中設定其優先順序，或從優先順序清單中移除本身。
語法
LONG lineSetAppPriorityW(
LPCWSTR lpszAppFilename,
DWORD dwMediaMode,
LPLINEEXTENSIONID lpExtensionID,
DWORD dwRequestMode,
LPCWSTR lpszExtensionName,
DWORD dwPriority
);
參數
lpszAppFilename
字串的指標，其中包含應用程式可執行檔模組檔名，不含目錄數據。 在 TAPI 2.0 版或更新版本中，參數可以使用 long 或 8.3 檔名格式來指定檔名。
dwMediaMode
要設定應用程式優先順序的媒體類型。 此值可以是一或多個 LINEMEDIAMODE 常數。 值零應該用來設定輔助電話語音要求的應用程式優先順序。
lpExtensionID
LINEEXTENSIONID 類型結構的指標。 這個參數會被忽略。
dwRequestMode
此參數的條件是，如果 dwMediaMode 參數為零，此參數會指定要設定優先權的 Assisted Telephony 要求模式。 它必須是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，dwMediaMod e 中指定的值不是零，也不是 LINEMEDIAMODE_ 常數之一。
此函式會更新預存的優先順序清單。 如果電話語音系統已初始化，它也會設定應用程式目前的作用中優先順序，然後執行;新的優先順序會根據媒體類型，用於下一個來電或 lineHandoff。
使用 lineSetAppPriority 設定的優先順序 將會在系統重新啟動或 tapisrv 重新啟動之間保存。 lineOpen 函式會開啟沒有指定呼叫優先順序的行。 根據預設，最高優先順序的應用程式會是第一個呼叫 lineOpen的第一個應用程式。
注意
tapi.h 標頭會根據 UNICODE 預處理器常數的定義，將 lineSetAppPriority 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的
要求
| 要求 | 價值 |
|---|---|
| 目標平臺 | 窗戶 |
| 標頭 | tapi.h |
| 連結庫 | Tapi32.lib |
| DLL | Tapi32.dll |