Skip to content

Latest commit

 

History

History
121 lines (94 loc) · 4.12 KB

nf-tapi3if-ittapi-setapplicationpriority.md

File metadata and controls

121 lines (94 loc) · 4.12 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:tapi3if.ITTAPI.SetApplicationPriority
ITTAPI::SetApplicationPriority (tapi3if.h)
The SetApplicationPriority method allows an application to set its priority in the handoff priority list for a particular media type or Assisted Telephony request mode, or to remove itself from the priority list.
ITTAPI interface [TAPI 2.2]
SetApplicationPriority method
ITTAPI.SetApplicationPriority
ITTAPI::SetApplicationPriority
SetApplicationPriority
SetApplicationPriority method [TAPI 2.2]
SetApplicationPriority method [TAPI 2.2]
ITTAPI interface
_tapi3_ittapi_setapplicationpriority
tapi3.ittapi_setapplicationpriority
tapi3if/ITTAPI::SetApplicationPriority
tapi3\ittapi_setapplicationpriority.htm
tapi3
ca049695-02d0-4b30-ad1f-60cdbf0a4dbd
12/05/2018
ITTAPI interface [TAPI 2.2],SetApplicationPriority method, ITTAPI.SetApplicationPriority, ITTAPI::SetApplicationPriority, SetApplicationPriority, SetApplicationPriority method [TAPI 2.2], SetApplicationPriority method [TAPI 2.2],ITTAPI interface, _tapi3_ittapi_setapplicationpriority, tapi3.ittapi_setapplicationpriority, tapi3if/ITTAPI::SetApplicationPriority
tapi3if.h
Tapi3.h
Windows
Uuid.lib
Tapi3.dll
Windows
19H1
ITTAPI::SetApplicationPriority
tapi3if/ITTAPI::SetApplicationPriority
c++
APIRef
kbSyntax
COM
Tapi3.dll
ITTAPI.SetApplicationPriority

ITTAPI::SetApplicationPriority

-description

The SetApplicationPriority method allows an application to set its priority in the handoff priority list for a particular media type or Assisted Telephony request mode, or to remove itself from the priority list.

-parameters

-param pAppFilename [in]

Pointer to BSTR containing name of application.

-param lMediaType [in]

Media associated with application.

-param fPriority [in]

The new priority for the application. If the value VARIANT_FALSE is passed, the application is removed from the priority list for the specified media or request mode (if it was already not present, no error is generated). If the value VARIANT_TRUE is passed, the application is inserted as the highest-priority application for the media or request mode (and removed from a lower-priority position, if it was already in the list).

-returns

This method can return one of these values.

Return code Description
S_OK
Method succeeded.
E_OUTOFMEMORY
Insufficient memory exists to perform the operation.

-remarks

The application must use SysAllocString to allocate memory for the pAppFilename parameter and use SysFreeString to free the memory when the variable is no longer needed.

The Priorities that are set with SetApplicationPriority will persist across reboots of the system or restarts of tapisrv. The ITTAPI::RegisterCallNotifications function opens the line with no specified call priorities. By default, the highest priority application will be the one that first called ITTAPI::RegisterCallNotifications.

-see-also

ITBasicCallControl::HandoffIndirect

ITTAPI

TAPI Object