lineGetAppPriority 函式 (tapi.h)

發行項
03/05/2024

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 格式指定檔名;無法使用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。