Symbian
Symbian OS Library

SYMBIAN OS V9.3

[Index] [Spacer] [Previous] [Next]



IAS queries

IrDA Information Acces Service (IAS) database queries are handled on the client side through the RNetDatabase class.

After instantiating and opening an RNetDatabase object, an IAS query is constructed from a TIASQuery object. The constructor of a TIASQuery requires two descriptors containing the IAS query class name and attribute name. The TIASQuery constructor also takes the remote device address of a discovered machine because when a query is made, the underlying IrLAP connection may not have been established.

At the protocol level, the IAS query code has been designed to kick up IrLAP and IrLMP layer connections if they are not present. An RNetDatabase::Query() call is invoked using a TIASResponse instance and the previously constructed TIASQuery object. This is an asynchronous call which completes with:

The application writer is assumed to have some knowledge of the format of IAS queries and responses even though comprehensive IAS response parsing functions are exported from the TIASResponse class. IAS response strings have the following valid formats:

Examples of key valid IAS queries and response types are given below with the Class and Attribute Names taking exactly the format they must pass on to a TIASQuery constructor.

IAS Class Name

IAS Attribute Name

Description of response

Response Type and Offset

Device

DeviceName*

Remote machines device nickname.

Type 3. User string.

Device

IrLMPSupport*

Level of IrMUX and IAS supported by remote station.

Type 2. Octet sequence.

IrDA:IrCOMM

Parameters

Collection of one or more parameters indicating the level of IrCOMM support

Type 2. Octet sequence.

IrDA:IrCOMM

IrDA:IrLMP:LsapSel

Range of remote IrMUX port numbers for IrCOMM service.

Type 1. Integer.

IrDA:IrCOMM

IrDA:TinyTP:LsapSel

Range of remote IrMUX port numbers for TinyTP service.

Type 1. Integer.

IrDA:IrCOMM

IrDA:InstanceName

Used to distinguish between otherwise identical IAS objects on remote station.

Type 3. User string.

IrDA:IrOBEX

IrDA:TinyTP:LsapSel

Range of IrMUX port numbers for IrOBEX service

Type 1. Integer.

IrLPT

IrDA:IrLMP:LsapSel

Range of remote IrMUX port numbers for remote station IrLPT (applies to IrDA printers only).

Type 1. Integer.

* Note that these two Device class attributes must be supported by an IrDA-compliant remote station.

The classes RNetDatabase, TIASQuery and TIASResponse are used for querying a remote stations IAS server.