3.1.1.3.11 ConfiguredInterfaces Table

The entries in the ConfiguredInterfaces table represent configured interfaces.

Table identifier: {D13B72C6-C426-11D1-8507-006008B0E79D}

AuxiliaryGuid: None.

Defined in catalog version: All catalog versions.

Prerequisites: None.

Hidden bitness property: No.

Supported query templates:

  • Catalog version 3.00:

    Cell 1

    CLSID equals <A>.

  • Catalog version 4.00 and catalog version 5.00:

    Cell 1

    Cell 2

    Cell 3

    CLSID equals <A>.

    PartitionIdentifier equals <B>.

    ConfigurationBitness equals <C>.

Primary key:

  • Catalog version 3.00: CLSID, IID

  • Catalog version 4.00 and catalog version 5.00: CLSID, PartitionIdentifier, Reserved, IID, ConfigurationBitness

Other referential constraints:

  • Catalog version 3.00: There MUST exist a component full configuration entry in ComponentsAndFullConfigurations (section 3.1.1.3.1) with an identical value for CLSID.

  • Catalog version 4.00 and catalog version 5.00: There MUST exist a component full configuration entry in ComponentsAndFullConfigurations (section 3.1.1.3.1) with identical values for CLSID, PartitionIdentifier, and ConfigurationBitness.

Write restrictions: Add and remove MUST NOT be supported.

Update MUST be supported if and only if:

  • The conglomeration in which the component full configuration associated with this interface is configured has the value "Y" for Changeable.

  • The conglomeration in which the component full configuration associated with this interface is configured has the value "N" for IsSystem.

  • Catalog version 4.00 and catalog version 5.00: The partition identified by PartitionIdentifier has the value "Y" for Changeable.

Cascade: On removal of an entry, all entries in the ConfiguredMethods (section 3.1.1.3.12) and RolesForInterface (section 3.1.1.3.14) tables with identical values of CLSID, PartitionIdentifier, and ConfigurationBitness properties MUST be removed.

Populate: None.

Properties:

Index (3.00)

Index (4.00/5.00)

Property name

Type

Size

Flags

Meta

0

0

CLSID

eDT_GUID

16

0x00000003

RO

-

1

PartitionIdentifier

eDT_GUID

16

0x00000003

RO

-

2

Reserved

eDT_GUID

16

0x00000003

RO

1

3

IID

eDT_GUID

16

0x00000003

RO

-

4

ConfigurationBitness

eDT_ULONG

4

0x00000003

RO

-

5

Name

eDT_LPWSTR

variable

0x00000002

RO

2

6

Internal1

eDT_BYTES

variable

0x00000000

IN

3

7

Internal2

eDT_GUID

16

0x00000000

IN

4

8

Internal3

eDT_ULONG

4

0x00000002

IN

5

9

IsQueueable

eDT_ULONG

4

0x00000002

6

10

IsQueuingSupported

eDT_ULONG

4

0x00000002

RO

7

11

Description

eDT_LPWSTR

variable

0x00000000

In the previous table, internal properties (marked with IN in the Meta column) MUST NOT be written to or interpreted by the client. The server's use of these properties is implementation-specific because it does not affect interoperability.

CLSID: The CLSID of the component configuration associated with the interface.

PartitionIdentifier: The partition in which the component associated with this interface resides.

Reserved: PlaceholderGuidProperty (section 2.2.2.1.2).

IID: The IID of the interface.<205>

ConfigurationBitness: A BitnessProperty (section 2.2.2.5) indicating the bitness of the component configuration associated with the interface.

Name: A NameProperty (section 2.2.2.6) providing a human readable name of the interface.<206>

IsQueueable: A BooleanProperty (section 2.2.2.9) that indicates whether the interface is enabled for queuing (section 3.1.1.1.5).<207> If TRUE, IsQueuingSupported MUST be TRUE.

IsQueuingSupported: A BooleanProperty that indicates whether or not queuing is possible for the interface.<208>

Description: A DescriptionProperty (section 2.2.2.7) providing a human readable description of the interface.<209>