IPNPXAssociation::Unassociate 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 unassociated. If a function instance is unassociated, then it is a not present instance and the device corresponding to the function instance is not available for use.

Syntax

HRESULT Unassociate(
  [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
S_OK
The method succeeded.
E_FAIL
The method failed.

Remarks

This method modifies the association database entry corresponding to the function instance from which the IPNPXAssociation interface was obtained.

This method does not remove the entry from the association database. To remove an entry from the association database, call IPNPXAssociation::Delete.

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

See also

IPNPXAssociation

IPNPXDeviceAssociation::Unassociate