SDK Home Glossary Index Left Right Up

IAS Query


Section contents


Overview

Defined in

csocket.oxh

Description

The IAS query object should be initialised with one of the following:

IAS Class Name IAS Attribute Name Description Response type
"Device" "DeviceName" Remote machine's device name KIASDataUserString&
"Device" "IrLMPSupport" Level of IrMUX and IAS supported by remote station KIASDataOctetSequence&
"IrDA:IrCOMM" "Parameters" One or more parameters indicating the level of IrCOMM support KIASDataOctetSequence&
"IrDA:IrCOMM" "IrDA:IrLMP:LsapSel" Range of remote IrMUX port numbers for IrCOMM service KIASDataUserInteger&
"IrDA:IrCOMM" "IrDA:TinyTP:LsapSel" Range of remote IrMUX port numbers for TinyTP service KIASDataUserInteger&
"IrDA:IrCOMM" "IrDA:InstanceName" Used to distinguish between otherwise identical IAS objects on remote stations KIASDataUserString&
"IrLPT" "IrDA:IrLMP:LsapSel" Range of remote IrMUX port numbers for remote station IrLPT KIASDataUserInteger&

The IAS query object is then used with the NewDatabaseQueryA routine. The asynchronous status value from the NewDatabaseQueryA routine has the following meanings:


Construction / destruction


NewIASQuery

Usage

this& = NewIASQuery&:(class$,attribute$,addr&)

Description

Creates an IAS query object and returns a handle to the created object.

Arguments
class$ The class name. The maximum length is KIASClassNameMax&
attribute$ The attribute name. The maximum length is KIASAttributeNameMax&
addr& A handle to a NetDatabase object
Return Value
this& A handle which represents the created IAS query object
Error Handling

If the object could not be created then an error is generated which should be trapped by an ONERR handler.

Example
  LOCAL this&,net&

  net& = NewNetDatabase&:
  this& = NewIASQuery&:("Device","DeviceName",net&)
  DeleteIASQuery:(this&)
  DeleteNetDatabase:(net&) 

DeleteIASQuery

Usage

DeleteIASQuery:(BYREF this&)

Description

Destroys the IAS query object.

Arguments
BYREF this& A handle for an IAS query object. A zero value is written back into the variable
Example
  LOCAL this$,net&

  net& = NewNetDatabase&:
  this& = NewIASQuery&:("Device","DeviceName",net&)
  DeleteIASQuery:(this&)
  DeleteNetDatabase:(net&) 

Methods provided


IASQueryGet

Usage

IASQueryGet:(this&,des&,ades&,BYREF addr&)

Description

Returns the class, the attribute name and remote device address defined in the IAS query object.

Arguments
this& A handle for an IAS query object
des& The class name
ades& The attibute name
BYREF addr& The remote device address

IASQuerySet

Usage

IASQuerySet:(this&,class$,attribute$,addr&)

Description

Sets the class name, attribute name and a handle to a net database object in the IAS query object.

Arguments
this& A handle for an IAS query object
class$ The class name. The maximum length is KIASClassNameMax&
attribute$ The attribute name. The maximum length is KIASAttributeNameMax&.
addr& A handle to a net database object

  SDK Home Glossary Index Left Right Up