Privilege the application wants to get for inbound and outbound calls when notified of a call. This property is used in conjunction with the MediaModes property which defines the media modes the application is interested in.
An application's privilege on a call it creates is always owner.
The sub-properties may be modified prior to setting the ThbTapiLine.Active property to True. Modifying this property while the component is actve has no effect.
ThbTapiLinePrivileges has some sub-properties: Owner, Monitor, None, AutoSelect, Value and Text.
Availability
Design-Time: Read, Write / Run-Time: Read, Write
Declaration
property Privileges: ThbTapiLinePrivileges;
Remarks
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 activation, ThbTapiLine tells TAPI which privilege level it requires. TAPI offers incoming sessions only to applications that have registered for either owner or owner and monitor privilege. The ability of the application to deal with incoming calls or to be the target of call handoffs on the line is determined by the MediaModes property and the selected privileges.
|
Mode(s) |
Typical application |
Meaning |
|
None |
Outbound application |
If the application just wants to make outgoing calls, it can specify privilege None (LINECALLPRIVILEGE_NONE). The application will receive notifications only for calls it makes. The application will not be notified of any inbound or outbound calls aside from the one it creates by it's onw. |
|
Monitor |
Monitoring of outbound and inbound calls |
The application will be notified of incoming and outgoing call
events but will not be the owner for the calls it doesn't make.
If the application just wants to monitor calls, then it can specify
privilege Monitor (LINECALLPRIVILEGE_MONITOR). |
|
Owner |
Inbound application |
Just like Monitor, but the application will be given ownership of any incoming call tha has a media type matching TTpiLine.MediaModes. If the application wants to handle incoming calls of the specified MediaModes, then it can use privilege Owner (LINECALLPRIVILEGE_OWNER). The application is NOT notified of calls, if another applications has already opened the line device with owner privileges to the calls media mode. |
|
Owner+Monitor |
Inbound and Outbound application |
Just like Owner, but the application will still receive notificationsfor calls it doesn't own, that is, calls make by other applications on the same system. If the application wants to handle incoming calls as an owner and it wants to be notified of outgoing calls too, then it can specify privilege Owner and Monitor (LINECALLPRIVILEGE_OWNER or LINECALLPRIVILEGE_MONITOR). The application will be notified of incoming call although another application has become the owner of the call. |
See Also
ThbTapiLine.Active | MediaModes , CallOptions.AutoOwner, ThbTapiCall.Owner
ThbTapiLine.Privileges.AutoSelect
Type: Boolean
Availability
Design-Time: Read, Write / Run-Time: Read, Write
ThbTapiLine selects the privileges automatically. ThbTapiLine tries to open the line with Owner+Monitor and, if this fails, with Monitor only.
 |
With AutoSelect set, you need to check the Privileges property after activating the line to become aware of the active privileges. |
ThbTapiLine.Privileges.Owner
Type: Boolean
Availability
Design-Time: Read, Write / Run-Time: Read, Write
The application wants to have owner privileges to inbound calls of the media type specified by the MediaModes property. These privilege allows the application to manipulate the call in ways that affect the state of the call.
The value of this property has no meaning if AutoSelect is True.
ThbTapiLine.Privileges.Monitor
Type: Boolean
Availability
Design-Time: Read, Write / Run-Time: Read, Write
The application wants to have owner privileges to inbound calls of the
media type specified by the MediaModes
property. These privilege allows the application to monitor state changes
and query information and status about the call. Use the ThbTapiCall.Owner
property to check the privilege and become the owner of a call.
The value of this property has no meaning if AutoSelect is True.
ThbTapiLine.Privileges.None
Type: Boolean
Availability
Design-Time: Read, Write / Run-Time: Read, Write
The application requires no privileges to inbound calls. Use this property if you're program is an outbound application and does ot handle incoming calls. You need to set this property also to True when you're using older modems with the Unimodem/UnimodemV Telephony Service Provider (TSP). Otherwise an EhbTapiError exception with an ErrorCode of LINEERR_INVALMEDIAMODE will raise.
Setting the value of this property to True will cause ThbTapiLine.Privilege.Monitor/Owner
to be set to False.
The value of this property has no meaning if AutoSelect is True.
ThbTapiLine.Privileges.Value
Type: DWORD
Availability
Design-Time: None / Run-Time: Read
The setting of privileges as a DWORD value using the LINECALLPRIVILEGE_ constants. You are able to use the property in conjunction with TAPI functions.
ThbTapiLine.Privileges.Text
Type: String
Availability
Design-Time: None / Run-Time: Read
The privileges as a textual counterpart. The value is for example 'OWNER+MONITOR'.