Compartir a través de

Método IPNPXDeviceAssociation::Unassociate (pnpxassoc.h)

  • Artículo

[Detección de funciones está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores.

Marca una entrada de base de datos de asociación como no asociada y envía una notificación adecuada.

Sintaxis

HRESULT Unassociate(
  [in, optional] const WCHAR                    *pszSubCategory,
  [in]           IFunctionDiscoveryNotification *pIFunctionDiscoveryNotification
);

Parámetros

[in, optional] pszSubCategory

Subcategoría de la base de datos de asociación en la que se almacena la entrada. Este parámetro puede ser NULL.

[in] pIFunctionDiscoveryNotification

Objeto IFunctionDiscoveryNotification que está registrado para las notificaciones con detección de funciones.

Valor devuelto

Entre los valores devueltos posibles se incluyen, entre otros, los siguientes.

Código devuelto Descripción
S_OK
 El método se ha llevado a cabo de forma correcta.
E_FAIL
 Error en el método.

Comentarios

Este método modifica la entrada de la base de datos de asociación correspondiente a la instancia de función desde la que se obtuvo la interfaz IPNPXDeviceAssociation .

La siguiente lógica se usa para determinar el método de devolución de llamada que se usa para la notificación:

  • Si se recibe una notificación PnP después de que el dispositivo no esté asociado, se llama al método IFunctionDiscoveryNotification::OnUpdate con el parámetro enumQueryUpdateAction establecido en QUA_REMOVE.
  • Si no se recibe ninguna notificación PnP después de que el dispositivo no esté asociado y no haya eventos PnP pendientes, se llama al método IFunctionDiscoveryNotification::OnError .
  • Por último, si no se recibe ninguna notificación PnP después de que el dispositivo no esté asociado y haya eventos PnP pendientes, no se llama a ningún método de devolución de llamada.
Este método no quita la entrada de la base de datos de asociación. Para quitar una entrada de la base de datos de asociación, llame a IPNPXAssociation::D elete.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado pnpxassoc.h

Consulte también

IPNPXAssociation::Unassociate

IPNPXDeviceAssociation