The GetTopologyObject method gets a reference to the IDeviceTopology interface of the device-topology object that contains this part.
- 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.
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.
Pointer ppTopology is NULL.
For code examples that use this method, see the following topics:
Minimum supported client
|Windows Vista [desktop apps only]|
Minimum supported server
|Windows Server 2008 [desktop apps only]|