IPart::GetTopologyObject method (devicetopology.h)
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
[out] ppTopology
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 code | Description |
---|---|
|
Pointer ppTopology is NULL. |
Remarks
For code examples that use this method, see the following topics:
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows Vista [desktop apps only] |
Minimum supported server | Windows Server 2008 [desktop apps only] |
Target Platform | Windows |
Header | devicetopology.h |