Symbian
Symbian OS Library

SYMBIAN OS V9.3

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



Location: bt_sock.h
Link against: bluetooth.lib

Class TInquirySockAddr

class TInquirySockAddr : public TSockAddr;

Description

Socket address class used for inquiries.

Used to specify the inquiry request, and then filled with information about remote devices discovered through the inquiry process.

Use the BTAddr() method to extract the device address to connect to.

Note: Usage of RHostResolver class for Bluetooth protocol.

The RHostResolver class is a generic interface to host name resolution services, such as DNS, that may be provided by particular protocol modules.

The points to remember when using RHostResolver::GetByAddress(), RHostResolver::GetByName(), or RHostResolver::Next() with Bluetooth protocol are:

1) If you operate on one instance of RHostResolver you can perform only one request by calling either RHostResolver::GetByAddress() or RHostResolver::GetByName(). If these functions are called again and if there is more than one possible response for a given host name then that will be returned (The host resolving process will not start from the beginning). It is exactly as if the RHostResolve::Next() method was called.

2) In order to start resolving new hosts from the beginning using the same instance of RHostResolver, the instance must be closed and reopened again.

3) In order to perform several RHostResolver requests they should be issued on separate instances of RHostResolver (many RHostResolver instances might exist and perform requests at the same time).

4) The KHostResIgnoreCache flag is only valid when issuing RHostResolver::GetByAddress() or RHostResolver::GetByName() request for the first time.

5) As an RHostResolver is only intended to be used once, it is recommended that it be closed as soon as it is finished with as the semantics of Cancel merely indicates that one client server request should be cancelled.

Derivation

Members

Defined in TInquirySockAddr:
Action(), BTAddr(), Cast(), FormatTypeField(), IAC(), MajorClassOfDevice(), MajorServiceClass(), MinorClassOfDevice(), SetAction(), SetBTAddr(), SetIAC(), SetMajorClassOfDevice(), SetMajorServiceClass(), SetMinorClassOfDevice(), TInquirySockAddr(), TInquirySockAddr(), Version()

Inherited from TSockAddr:
CmpPort(), Family(), GetUserLen(), Port(), SetFamily(), SetPort(), SetUserLen(), UserPtr()


Construction and destruction


TInquirySockAddr()

IMPORT_C TInquirySockAddr();

Description

Constructor


TInquirySockAddr()

IMPORT_C TInquirySockAddr(const TSockAddr &aSockAddr);

Description

Parameters

const TSockAddr &aSockAddr

[Top]


Member functions


BTAddr()

IMPORT_C TBTDevAddr BTAddr() const;

Description

Getter

Return value

TBTDevAddr

The device address specified by this Socket address.


SetBTAddr()

IMPORT_C void SetBTAddr(const TBTDevAddr &aRemote);

Description

Sets BT address from a TBTDevAddr.

Parameters

const TBTDevAddr &aRemote

TBTDevAddr to be used


Cast()

static IMPORT_C TInquirySockAddr &Cast(const TSockAddr &aSockAddr);

Description

Parameters

const TSockAddr &aSockAddr

Return value

TInquirySockAddr &


MajorServiceClass()

IMPORT_C TUint16 MajorServiceClass() const;

Description

Return value

TUint16


SetMajorServiceClass()

IMPORT_C void SetMajorServiceClass(TUint16 aClass);

Description

Parameters

TUint16 aClass


MajorClassOfDevice()

IMPORT_C TUint8 MajorClassOfDevice() const;

Description

Return value

TUint8


SetMajorClassOfDevice()

IMPORT_C void SetMajorClassOfDevice(TUint8 aMajorClassOfDevice);

Description

Parameters

TUint8 aMajorClassOfDevice


MinorClassOfDevice()

IMPORT_C TUint8 MinorClassOfDevice() const;

Description

Return value

TUint8


SetMinorClassOfDevice()

IMPORT_C void SetMinorClassOfDevice(TUint8 aMinorClassOfDevice);

Description

Parameters

TUint8 aMinorClassOfDevice


IAC()

IMPORT_C TUint IAC() const;

Description

Return value

TUint


SetIAC()

IMPORT_C void SetIAC(const TUint aIAC);

Description

Parameters

const TUint aIAC


Action()

IMPORT_C TUint8 Action() const;

Description

Return value

TUint8


SetAction()

IMPORT_C void SetAction(TUint8 aFlags);

Description

Parameters

TUint8 aFlags


Version()

IMPORT_C TVersion Version() const;

Description

Gets the version number

Return value

TVersion


FormatTypeField()

protected: IMPORT_C TUint8 FormatTypeField() const;

Description

Gets the Format Type Field number

Return value

TUint8