Aufheben der Registrierung eines Geräts

Verwenden Sie die IUPnPRegistrar::UnregisterDevice-Methode , um die Registrierung eines Geräts aufzuheben. Das Gerät kann je nach Wert von fPermanent vorübergehend oder dauerhaft aufgehoben (aus dem Gerätehost entfernt) werden. Entwickler sollten Geräte vorübergehend entfernen, wenn die Geräte erneut registriert werden, und die Geräte sollten denselben UDN verwenden. Andernfalls werden die Geräte dauerhaft entfernt.

Die zum Aufheben der Registrierung verwendete GUID ist nicht der UDN. Sie müssen die ID verwenden, die Ihnen von IUPnPRegistrar::RegisterDevice oder IUPnPRegistrar::RegisterRunningDevice zurückgegeben wurde.

Hinweis

Sie können das IUPnPRegistrar-Objekt freigeben. Nur die ID muss zwischengespeichert werden.

 

Wenn fPermanentFALSE ist, wird das Gerät vorübergehend entfernt. Verwenden Sie die IUPnPReregistrar-Schnittstelle , um das Gerät erneut zu registrieren. Die Methoden IUPnPReregistrar::ReregisterDevice und IUPnPReregistrar::ReregisterRunningDevice verwenden im Fall geschachtelter Geräte dieselben UDNs oder UDNs, die zuvor vom Gerätehost für das nicht registrierte Gerät generiert wurden.

Wenn fPermanentTRUE ist, wird das Gerät dauerhaft vom Gerätehost entfernt. Wenn Sie dieses Gerät erneut auf demselben Computer registrieren, wird ein anderer UDN als der zuvor erstellte erstellt.

Hinweis

Wenn ein Gerät mehrmals auf demselben Computer registriert wird, generiert der Gerätehost unterschiedliche UDNs für jede instance des Geräts.