IUPnPReregistrar::ReregisterRunningDevice-Methode (upnphost.h)
Die ReregisterRunningDevice-Methode registriert ein ausgeführtes Gerät erneut beim Gerätehost. Die Geräteinformationen werden vom Gerätehost gespeichert. Anschließend gibt der Gerätehost eine Geräte-ID zurück und veröffentlicht und kündigt das Gerät im Netzwerk an. Die Veröffentlichung dieses Geräts wird nicht über Systemboote hinweg beibehalten.
Syntax
HRESULT ReregisterRunningDevice(
[in] BSTR bstrDeviceIdentifier,
[in] BSTR bstrXMLDesc,
[in] IUnknown *punkDeviceControl,
[in] BSTR bstrInitString,
[in] BSTR bstrResourcePath,
[in] long nLifeTime
);
Parameter
[in] bstrDeviceIdentifier
Gibt den Gerätebezeichner des Geräts an. Dies muss derselbe Bezeichner sein, der von IUPnPRegistrar::RegisterRunningDevice im pbstrDeviceIdentifier-Parameter zurückgegeben wird.
[in] bstrXMLDesc
Gibt die XML-Gerätebeschreibungsvorlage des zu registrierenden Geräts an.
[in] punkDeviceControl
Gibt den IUnknown-Zeiger auf das Gerätesteuerungsobjekt des Geräts an.
[in] bstrInitString
Identifiziert die für das Gerät spezifische Initialisierungszeichenfolge. Diese Zeichenfolge wird später an IUPnPDeviceControl::Initialize übergeben.
[in] bstrResourcePath
Gibt den Speicherort des Ressourcenverzeichnisses des Geräts an. Dieses Ressourcenverzeichnis enthält die Symboldateien und Dienstbeschreibungen, die in der Gerätebeschreibungsvorlage bstrXMLDesc angegeben sind.
[in] nLifeTime
Gibt die Lebensdauer der Geräteankündigung in Sekunden an. Nach Ablauf des Timeouts werden die Ankündigungen aktualisiert. Wenn Sie null angeben, wird der Standardwert 1800 (30 Minuten) verwendet. Der zulässige Mindestwert beträgt 900 (15 Minuten); Wenn Sie etwas kleiner als 900 angeben, wird ein Fehler zurückgegeben.
Rückgabewert
Wenn die Methode erfolgreich ist, wird der Rückgabewert S_OK. Andernfalls gibt die Methode einen der in WinError.h definierten COM-Fehlercodes oder einen der folgenden UPnP-spezifischen Fehlercodes zurück.
| Rückgabecode | Beschreibung |
|---|---|
|
Das Gerät wurde nicht registriert. Verwenden Sie RegisterRunningDevice , um ein nicht registriertes Gerät zu registrieren. |
|
Ein doppeltes Element ist vorhanden. |
|
Eine doppelte Dienst-ID für einen Dienst innerhalb desselben übergeordneten Geräts ist vorhanden. |
|
Die Gerätebeschreibung ist ungültig. |
|
Im Symbolelement der Gerätebeschreibung ist ein Fehler vorhanden. |
|
In einem Dienstelement in der Gerätebeschreibung ist ein Fehler vorhanden. |
|
Ein erforderliches Element fehlt. |
Hinweise
Der Client, der diese Methode aufruft, muss die Identität localService annehmen können, um die Verarbeitung dieser Methode abschließen zu können.
Die IUPnPDeviceControl::Initialize-Methode wird aufgerufen, wenn die erste Steuerelement- oder Ereignisanforderung empfangen wird.
Die Registrierung dieses Geräts wird nicht über Systemboote hinweg beibehalten.
Häufige Fehler, die beim Aufrufen dieser Funktion auftreten können, sind:
- Das erforderliche COM-Objekt wurde nicht gefunden.
- Es gibt keinen Zugriff auf das COM-Objekt für LocalService.
- Untergeordnete COM-Schnittstellen.
- Die XML-Beschreibungsgrenzwerte (siehe Erstellen einer Gerätebeschreibung).
Anforderungen
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | upnphost.h |
| DLL | Upnphost.dll |
Weitere Informationen
IUPnPRegistrar::RegisterRunningDevice