IUPnPDescriptionDocument::RootDevice

This method returns the root device of the currently loaded document's device tree.

HRESULT RootDevice(
  IUPnPDevice** ppudRootDevice
);

Parameters

  • ppudRootDevice
    [out] Receives a reference to an IUPnPDevice:IDispatch object that describes the device. This reference must be released when it is no longer required.

Return Values

  • S_OK
    This method was successful.

Otherwise, the method returns one of the COM error codes defined in WinError.h.

Remarks

Do not use IUPnPDescriptionDocument::RootDevice unless a device description is first loaded using either IUPnPDescriptionDocument::Load orIUPnPDescriptionDocument::LoadAsync.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Upnp.h.
Link Library: Uuid.lib.

See Also

IUPnPDescriptionDocument:IDispatch | IUPnPDevice:IDispatch

 Last updated on Saturday, April 10, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.