IUPnPDevice::get_ParentDevice method (upnp.h)

Article
02/22/2024

The ParentDevice property specifies the parent of the device.

Syntax

HRESULT get_ParentDevice(
  [out] IUPnPDevice **ppudDeviceParent
);

Parameters

[out] ppudDeviceParent

Receives a reference to an IUPnPDevice object that describes the parent device. This reference must be released when it is no longer required. If the device has no parent, it is a topmost device, and the parameter receives NULL.

Return value

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

Remarks

To determine if the device has no parent, use IUPnPDevice::IsRootDevice.

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