IUPnPDevice::get_Children method (upnp.h)

Article
02/22/2024

The Children property specifies all the child devices of the device. The devices are stored in an IUPnPDevices collection.

Syntax

HRESULT get_Children(
  [out] IUPnPDevices **ppudChildren
);

Parameters

[out] ppudChildren

Receives a reference to an IUPnPDevices collection that enumerates the child devices of the device. This reference must be released when it is no longer required.

If the device has no child devices, the collection object has a length of zero.

Return value

For C++: If this property's "get" method succeeds, the return value is S_OK. Otherwise, the method returns one of the COM error codes defined in WinError.h.

Remarks

To determine if a device has any children (but not the actual number of children), use IUPnPDevice::HasChildren.

Requirements

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	None supported
Target Platform	Windows
Header	upnp.h
DLL	Upnp.dll