Privilege

Privilege refers to whether an application owns or is monitoring the session. If the application owns the session, it is allowed to perform a variety of session operations. If the application is only monitoring, it will receive state messages and it can access session information, but any attempt to perform most operations will result in an error.

During initialization, an application tells TAPI which privilege level it requires on which addresses. TAPI offers incoming sessions only to applications that have registered for either owner or owner and monitor privilege.

An application's privilege on a session it creates is always owner.

TAPI 2.x: See lineGetCallStatus, dwCallPrivilege member of LINECALLSTATUS, lineSetCallPrivilege.

TAPI 3.x: See ITCallInfo::get_Privilege, ITCallInfo::get_CallInfoLong, called with the CIL_NUMBEROFOWNERS or CIL_NUMBEROFMONITORS member of CALLINFO_LONG.