Método IUPnPRegistrar::UnregisterDevice (upnphost.h)

El método UnregisterDevice anula el registro del dispositivo del host del dispositivo. Un dispositivo se anula temporalmente o permanentemente.

Sintaxis

HRESULT UnregisterDevice(
  [in] BSTR bstrDeviceIdentifier,
  [in] BOOL fPermanent
);

Parámetros

[in] bstrDeviceIdentifier

Especifica el identificador de dispositivo del dispositivo que se va a anular el registro. El identificador del dispositivo se devolvió desde una llamada anterior a RegisterDevice o RegisterRunningDevice.

[in] fPermanent

Especifica si se va a anular el registro permanente o temporal del dispositivo. Especifique TRUE para anular el registro del dispositivo de forma permanente desde el host del dispositivo. Especifique FALSE para anular el registro temporalmente.

Valor devuelto

Si el método se realiza correctamente, el valor devuelto es S_OK. De lo contrario, el método devuelve uno de los códigos de error COM definidos en WinError.h.

Comentarios

Este método quita un dispositivo del host del dispositivo. Si fPermanent es TRUE, el dispositivo se anula de forma permanente. De lo contrario, el dispositivo persiste en la asignación del host del dispositivo del identificador del dispositivo (devuelto de RegisterDevice o RegisterRunningDevice) a la UDN generada por el host del dispositivo. Si un dispositivo no se registra temporalmente, cuando el dispositivo se vuelva a registrar, use el UDN anterior asociado al dispositivo.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	upnphost.h
Archivo DLL	Upnphost.dll

Consulte también

IUPnPRegistrar

IUPnPReregistrar

IUPnPReregistrar::RegisterDevice

IUPnPReregistrar::RegisterRunningDevice