ITTAPI::SetApplicationPriority method (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.

Syntax

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

Parameters

[in] pAppFilename

Pointer to BSTR containing name of application.

[in] lMediaType

Media associated with application.

[in] fPriority

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).

Return value

This method can return one of these values.

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.

Requirements

See also

ITBasicCallControl::HandoffIndirect

ITTAPI

TAPI Object