lineGetAppPriority 函式可讓應用程式判斷它是否位於特定媒體模式或輔助電話語音要求模式的交接優先順序清單中，如果是的話，它會在優先順序清單中的位置。
語法
LONG lineGetAppPriorityA(
LPCSTR lpszAppFilename,
DWORD dwMediaMode,
LPLINEEXTENSIONID lpExtensionID,
DWORD dwRequestMode,
LPVARSTRING lpExtensionName,
LPDWORD lpdwPriority
);
參數
lpszAppFilename
字串的指標，其中包含應用程式可執行檔模組檔名，不含目錄數據。 在 API 2.0 版或更新版本中，參數可以是長檔名格式，其中 8.3 檔名格式是適當的子集。 與 8.3 檔名不同的長檔名會保留大小寫。 兩個檔名格式都不區分大小寫。 如需詳細資訊，請參閱
dwMediaMode
要取得優先權數據的媒體模式。 值可以是其中一個 LINEMEDIAMODE_ 常數;只能開啟單一位。 驗證輔助電話要求的應用程式優先順序時，應該使用值 0。
lpExtensionID
LINEEXTENSIONID 類型結構的指標。 這個參數會被忽略。
dwRequestMode
此參數的條件是，如果 dwMediaMode 參數為零，此參數會指定要檢查優先順序的 Assisted Telephony 要求模式。 它必須是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。
言論
如果傳回LINEERR_INVALMEDIAMODE，dwMediaMod e 中指定的值不是零，不是有效的擴充媒體模式，也不是參數值中的其中一個 LINEMEDIAMODE_ 常數，或參數值中有一個以上的位。
注意
tapi.h 標頭會根據 UNICODE 預處理器常數的定義，將 lineGetAppPriority 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的
要求
| 要求 | 價值 |
|---|---|
| 目標平臺 | 窗戶 |
| 標頭 | tapi.h |
| 連結庫 | Tapi32.lib |
| DLL | Tapi32.dll |