lineSetAppPriority 函式 (tapi.h)

發行項
03/02/2024

lineSetAppPriority 函式可讓應用程式在特定媒體類型或輔助電話語音要求模式的遞交優先順序清單中設定其優先順序，或從優先順序清單中移除本身。

語法

LONG lineSetAppPriority(
  LPCSTR            lpszAppFilename,
  DWORD             dwMediaMode,
  LPLINEEXTENSIONID lpExtensionID,
  DWORD             dwRequestMode,
  LPCSTR            lpszExtensionName,
  DWORD             dwPriority
);

參數

lpszAppFilename

包含應用程式可執行檔模組檔名的字串指標，不含目錄數據。在 TAPI 2.0 版或更新版本中，參數可以指定 long 或 8.3 檔名格式的檔名。

dwMediaMode

要設定應用程式優先順序的媒體類型。此值可以是一或多個 LINEMEDIAMODE 常數。值零應該用來設定輔助電話語音要求的應用程式優先順序。

lpExtensionID

LINEEXTENSIONID 類型的結構的指標。這個參數已忽略。

dwRequestMode

此參數的條件是，如果 dwMediaMode 參數為零，此參數會指定要設定優先順序的輔助電話語音要求模式。它必須LINEREQUESTMODE_MAKECALL。如果 dwMediaMode 為非零值，則會忽略此參數。

lpszExtensionName

這個參數已忽略。

dwPriority

參數，表示應用程式的新優先順序。如果傳遞值 0，則會從指定媒體或要求模式的優先順序清單中移除應用程式;如果尚未存在，則不會產生任何錯誤。如果傳遞值 1，則會將應用程式插入為媒體或要求模式的最高優先順序應用程式;如果已在清單中，則會從優先順序較低的位置中移除。任何其他值都會產生錯誤。

傳回值

如果要求成功，則傳回零，如果發生錯誤，則傳回負錯誤號碼。可能的傳回值為：

LINEERR_INIFILECORRUPT、LINEERR_INVALREQUESTMODE、LINEERR_INVALAPPNAME、LINEERR_NOMEM、LINEERR_INVALMEDIAMODE、LINEERR_OPERATIONFAILED、LINEERR_INVALPARAM、LINEERR_RESOURCEUNAVAILLINEERR_INVALPOINTER。