IUPnPDevice::get_Children-Methode (upnp.h)
Die Children-Eigenschaft gibt alle untergeordneten Geräte des Geräts an. Die Geräte werden in einer IUPnPDevices-Auflistung gespeichert.
Syntax
HRESULT get_Children(
[out] IUPnPDevices **ppudChildren
);
Parameter
[out] ppudChildren
Empfängt einen Verweis auf eine IUPnPDevices-Auflistung , die die untergeordneten Geräte des Geräts aufzählt. Dieser Verweis muss freigegeben werden, wenn er nicht mehr erforderlich ist.
Wenn das Gerät keine untergeordneten Geräte hat, hat das Auflistungsobjekt eine Länge von 0.
Rückgabewert
Für C++: Wenn die "get"-Methode dieser Eigenschaft erfolgreich ist, wird der Rückgabewert S_OK. Andernfalls gibt die Methode einen der in WinError.h definierten COM-Fehlercodes zurück.
Hinweise
Verwenden Sie IUPnPDevice::HasChildren, um festzustellen, ob ein Gerät über untergeordnete Elemente verfügt (aber nicht über die tatsächliche Anzahl von untergeordneten Elementen).
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 |