IUPnPRegistrar::UnregisterDevice-Methode (upnphost.h)
Die UnregisterDevice-Methode hebt die Registrierung des Geräts beim Gerätehost auf. Ein Gerät wird entweder vorübergehend oder dauerhaft nicht registriert.
Syntax
HRESULT UnregisterDevice(
[in] BSTR bstrDeviceIdentifier,
[in] BOOL fPermanent
);
Parameter
[in] bstrDeviceIdentifier
Gibt den Gerätebezeichner des Geräts an, das die Registrierung aufheben soll. Der Gerätebezeichner wurde von einem vorherigen Aufruf von RegisterDevice oder RegisterRunningDevice zurückgegeben.
[in] fPermanent
Gibt an, ob die Registrierung des Geräts dauerhaft oder vorübergehend aufgehoben werden soll. Geben Sie TRUE an, um die Registrierung des Geräts dauerhaft beim Gerätehost aufzuheben. Geben Sie FALSE an, um die Registrierung vorübergehend aufzuheben.
Rückgabewert
Wenn die Methode erfolgreich ist, wird der Rückgabewert S_OK. Andernfalls gibt die Methode einen der com-Fehlercodes zurück, die in WinError.h definiert sind.
Hinweise
Mit dieser Methode wird ein Gerät vom Gerätehost entfernt. Wenn fPermanentauf TRUE festgelegt ist, wird die Registrierung des Geräts dauerhaft aufgehoben. Andernfalls bleibt das Gerät in der Zuordnung des Gerätehosts der Geräte-ID (zurückgegeben von RegisterDevice oder RegisterRunningDevice) zu dem vom Gerätehost generierten UDN erhalten. Wenn die Registrierung eines Geräts vorübergehend aufgehoben wird, verwenden Sie bei der erneuten Registrierung des Geräts den vorherigen UDN, der dem Gerät zugeordnet ist.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | upnphost.h |
| DLL | Upnphost.dll |