IPNPXAssociation::Associate method (pnpxassoc.h)
[Function Discovery is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]
Marks an association database entry as associated. If there is no association database entry for the function instance, one is created; otherwise the existing entry is updated.
Syntax
HRESULT Associate(
[in, optional] const WCHAR *pszSubcategory
);
Parameters
[in, optional] pszSubcategory
The subcategory of the association database in which the entry is stored. This parameter can be NULL.
Return value
Possible return values include, but are not limited to, the following.
| Return code | Description |
|---|---|
|
The method succeeded. |
|
The method failed. |
Remarks
This method modifies the association database entry corresponding to the function instance from which the IPNPXAssociation interface was obtained.
Once a device is associated, the PnP-X Service IP Bus Enumerator (IPBusEnum) sends a request to the PnP component to create the device devnode. The Found New Hardware wizard appears if user intervention is required to install a device driver after association.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista [desktop apps only] |
| Minimum supported server | Windows Server 2008 [desktop apps only] |
| Target Platform | Windows |
| Header | pnpxassoc.h |