ITTAPI：：SetApplicationPriority 方法 (tapi3if.h)

  • 發行項

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

語法

HRESULT SetApplicationPriority(
  [in] BSTR         pAppFilename,
  [in] long         lMediaType,
  [in] VARIANT_BOOL fPriority
);

參數

[in] pAppFilename

包含應用程式名稱的 BSTR 指標。

[in] lMediaType

與應用程式相關聯的媒體。

[in] fPriority

應用程式的新優先順序。 如果傳遞VARIANT_FALSE值，則會從指定的媒體或要求模式的優先順序清單中移除應用程式， (如果尚未出現，則不會產生任何錯誤) 。 如果傳遞VARIANT_TRUE值，則會將應用程式插入為媒體或要求模式的最高優先順序應用程式 (，如果它已在清單中) ，則會從較低優先順序的位置中移除。

傳回值

這個方法可以傳回下列其中一個值。

傳回碼 描述
S_OK
 方法成功。
E_OUTOFMEMORY
 記憶體不足，無法執行作業。

備註

應用程式必須使用 SysAllocString 為 pAppFilename 參數配置記憶體，並在不再需要變數時使用 SysFreeString 釋放記憶體。

以 SetApplicationPriority 設定 的優先順序將會在系統重新啟動或 tapisrv 重新啟動時保存。 ITTAPI：：RegisterCallNotifications 函式會開啟沒有指定呼叫優先順序的行。 根據預設，最高優先順序的應用程式會是第一個稱為 ITTAPI：：RegisterCallNotifications的應用程式。

規格需求

需求 值
目標平台 Windows
標頭 tapi3if.h (包括 Tapi3.h)
程式庫 Uuid.lib
Dll Tapi3.dll

另請參閱

ITBasicCallControl：：HandoffIndirect

ITTAPI

TAPI 物件