IUPnPDescriptionDocument::RootDevice-Methode (upnp.h)
Die RootDevice-Methode gibt das Stammgerät der Gerätestruktur des aktuell geladenen Dokuments zurück.
Syntax
HRESULT RootDevice(
[out] IUPnPDevice **ppudRootDevice
);
Parameter
[out] ppudRootDevice
Empfängt einen Verweis auf ein IUPnPDevice-Objekt , das das Gerät beschreibt. Dieser Verweis muss freigegeben werden, wenn er nicht mehr benötigt wird.
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
Verwenden Sie RootDevice nur, wenn eine Gerätebeschreibung zuerst mit IUPnPDescriptionDocument::Load oder IUPnPDescriptionDocument::LoadAsync geladen wird. Der Suchvorgang sucht nur in der aktuell geladenen Gerätebeschreibung.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | upnp.h |
| DLL | Upnp.dll |