Cancelar o registro de um dispositivo

Use o método IUPnPRegistrar::UnregisterDevice para cancelar o registro de um dispositivo. O dispositivo pode ser cancelado (removido do host do dispositivo) temporariamente ou permanentemente, dependendo do valor de fPermanent. Os desenvolvedores devem remover dispositivos temporariamente se os dispositivos forem registrados novamente e os dispositivos devem usar o mesmo UDN. Caso contrário, os dispositivos serão removidos permanentemente.

O GUID usado para cancelar o registro não é o UDN. Você deve usar a ID retornada por IUPnPRegistrar::RegisterDevice ou IUPnPRegistrar::RegisterRunningDevice.

Observação

Você pode liberar o objeto IUPnPRegistrar . Somente a ID deve ser armazenada em cache.

 

Se fPermanent for FALSE, o dispositivo será removido temporariamente. Use a interface IUPnPReregistrar para registrar novamente o dispositivo. Os métodos IUPnPReregistrar::ReregisterDevice e IUPnPReregistrar::ReregisterRunningDevice usam o mesmo UDN ou UDNs, no caso de dispositivos aninhados, gerados anteriormente pelo host do dispositivo para o dispositivo não registrado.

Se fPermanent for TRUE, o dispositivo será permanentemente removido do host do dispositivo. Registrar esse dispositivo novamente no mesmo computador cria um UDN diferente do criado anteriormente.

Observação

Quando um dispositivo é registrado várias vezes no mesmo computador, o host do dispositivo gera UDNs diferentes para cada instância do dispositivo.