Export (0) Print
Expand All

IPart::GetTopologyObject method

The GetTopologyObject method gets a reference to the IDeviceTopology interface of the device-topology object that contains this part.

Syntax


HRESULT GetTopologyObject(
  [out]  IDeviceTopology **ppTopology
);

Parameters

ppTopology [out]

Pointer to a pointer variable into which the method writes the address of the IDeviceTopology interface of the device-topology object. The caller obtains a counted reference to the interface from this method. Through this method, the caller obtains a counted reference to the interface. The caller is responsible for releasing the interface, when it is no longer needed, by calling the interface's Release method. If the GetTopologyObject call fails, *ppTopology is NULL.

Return value

If the method succeeds, it returns S_OK. If it fails, possible return codes include, but are not limited to, the values shown in the following table.

Return codeDescription
E_POINTER

Pointer ppTopology is NULL.

 

Remarks

For code examples that use this method, see the following topics:

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Devicetopology.h

See also

IDeviceTopology Interface
IPart Interface

 

 

Community Additions

ADD
Show:
© 2014 Microsoft