Compartilhar via


IAS_SET

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This structure contains data for creating an Information Access Service (IAS) object.

Syntax

typedef struct _IAS_SET {
  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_SET, *PIAS_SET;

Members

  • 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 OctetSeq in octets, or bytes. It is a value from 0 through 1024.
  • OctetSeq(IAS_ATTRIB_OCTETSEQ)
    A binary value to associate with irdaAttribName.
  • Len(IAS_ATTRIB_STR)
    Length of UsrStr, in octets. It is a value from 0 through 255.
  • CharSet(IAS_ATTRIB_STR)
    The selected character set. The following table shows the possible values.

    Value Description

    LmCharSetASCII

    LmCharSetISO_8859_5

    LmCharSetISO_8859_1

    LmCharSetISO_8859_6

    LmCharSetISO_8859_2

    LmCharSetISO_8859_7

    LmCharSetISO_8859_3

    LmCharSetISO_8859_8

    LmCharSetISO_8859_4

    LmCharSetISO_8859_9

  • 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 UsrStr is associated with irdaAttribName, it is necessary to allocate additional buffer space.

The Windows Embedded CE irdaClassName and irdaAttribName members have different maximum lengths than their Windows counterparts. The irdaAttribType, Len, and irdaAttribInt members also have different types.

The IAS_SET structure 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

Reference

IAS_QUERY

Concepts

IrDA Reference
IrDA Application Development

Other Resources

Infrared Communications