IPNPXDeviceAssociation interface

[Function Discovery is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]

Defines methods to manage the association database entries for PnP-X devices. These methods send notifications when the corresponding PnP devnode changes. An application calls IPNPXDeviceAssociation methods when the application programmatically manages PnP-X device association, either through a custom user interface or through some other method. Usually, the Network Explorer is used to manage PnP-X device association.

When to use

The IPNPXDeviceAssociation interface should be used to manage the addition and removal of entries from the association database when notifications are required. If notifications are not required, use the IPNPXAssociation interface instead.

Members

The IPNPXDeviceAssociation interface inherits from the IUnknown interface. IPNPXDeviceAssociation also has these types of members:

Methods

The IPNPXDeviceAssociation interface has these methods.

MethodDescription
IPNPXDeviceAssociation::Associate

Marks an association database entry as associated and sends an appropriate notification.

IPNPXDeviceAssociation::Delete

Removes an entry from the association database and sends an appropriate notification.

IPNPXDeviceAssociation::Unassociate

Marks an association database entry as unassociated and sends an appropriate notification.

 

Remarks

This interface is obtained by calling QueryService on a function instance returned by a Function Discovery query. The following pseudocode shows the parameters to use for the QueryService call.

QueryService( SID_PNPXAssociation, __uuidof( IPNPXDeviceAssociation ) )

The IPNPXDeviceAssociation methods modify the association database entry for the function instance upon which QueryService was called.

Not all function instances can be associated using the IPNPXDeviceAssociation methods. The function instance must have its PKEY_PNPX_GlobalIdentity key populated with the UUID supplied by the Function Discovery provider used to discover the device. For more information about property keys, see PnP-X Provider PKEYs.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

End of client support

Windows 7

End of server support

Windows Server 2008 R2

Header

Pnpxassoc.h

IDL

Pnpxassoc.idl

See also

IPNPXAssociation

 

 

Community Additions

ADD
Show:
© 2014 Microsoft