Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This structure contains data for an Information Access Service (IAS) object obtained from querying a remote device.

Syntax 

typedef struct IAS_QUERY {
  u_char 
irdaDeviceID[4];
  char 
irdaClassName[61];
  char 
irdaAttribName[61];
  u_short 
irdaAttribType;
  union {
	int 
irdaAttribInt;
	struct {
	int 
Len;
	u_char 
OctetSeq[1];
	u_char 
Reserved[3];
} irdaAttribOctetSeq;
	struct {
	int 
Len;
	u_char 
CharSet;
	u_char 
UsrStr[1];
	u_char 
Reserved[2];
} irda AttribUsrStr;
  } irdaAttribute; 
} _IAS_QUERY, *PIAS_QUERY;

Members

irdaDeviceID

Device identifier of the remote device to query.

irdaClassName

Null-terminated string that is the class name for an IAS object. Maximum of 60 characters.

irdaAttribName

Null-terminated string that is the attribute name for an IAS object. Maximum of 60 characters.

irdaAttribType

Attribute type, set to one of the values in the following table.

Value Description

IAS_ATTRIB_INT

Identifies an integer attribute value.

IAS_ATTRIB_OCTETSEQ

Identifies a binary, or octet, attribute value.

IAS_ATTRIB_STR

Identifies a string attribute value.
irdaAttribInt

32-bit signed integer attribute value.

Len(IAS_ATTRIB_OCTETSEQ)

Length of OctetSeqin octets or bytes. It is a value from 0 through 1024.

OctetSeq(IAS_ATTRIB_OCTETSEQ)

Binary value to associate with irdaAttribName.

Reserved

This is used to DWORD-align the structure.

Len(IAS_ATTRIB_STR)

Length of UsrStr, in octets. It is a value from 0 through 255.

CharSet(IAS_ATTRIB_STR)

Selected character set. The following table shows the possible values.

Value Description

LmCharSetASCII

LmCharSetISO_8859_6

LmCharSetISO_8859_1

LmCharSetISO_8859_7

LmCharSetISO_8859_2

LmCharSetISO_8859_8

LmCharSetISO_8859_3

LmCharSetISO_8859_9

LmCharSetISO_8859_4

LmCharSetUNICODE

LmCharSetISO_8859_5

 
UsrStr(IAS_ATTRIB_STR)

User string to associate with irdaAttribName.

Reserved

This is used to DWORD-align the structure.

Remarks

If either the octet sequence specified in OctetSeq, or the user string specified in UsrStris associated with irdaAttribName, it is necessary to allocate additional buffer space.

The remote device is queried for the attributes of an IAS object with the specified irdaClassNameand irdaAttribName. If an attribute of the specified object is not found on the remote device, then the irdaAttribTypeis set to IAS_ATTRIB_NO_ATTRIB to indicate that no attribute was found.

The Windows Embedded CE irdaClassNameand irdaAttribNamemembers have different maximum lengths than their Windows counterparts. The irdaAttribType, Len, and irdaAttribIntmembers also have different types.

The Windows Embedded CE IAS_SETstructure does not contain the required buffer space for either the octet sequence attributes or user string sequence attributes. To ensure that the buffer is large enough to query all remote objects, the maximum required buffer is sizeof(IAS_SET)+1024, which is the maximum attribute value length for an octet sequence.

Requirements

Header af_irda.h
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also