Platform SDK: TAPI

ITTAPI::SetApplicationPriority

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.

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

Parameters

pAppFilename
[in] Pointer to BSTR containing name of application.
lMediaType
[in] Media associated with application.
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).

Return Values

Value Meaning
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.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Version: Requires TAPI 3.0 or later.
  Header: Declared in Tapi3.h.
  Library: Use T3iid.lib.

See Also

ITTAPI, ITBasicCallControl::HandoffIndirect, TAPI Object