Share via

IPart::GetTopologyObject-Methode (devicetopology.h)

  • Artikel

Die GetTopologyObject-Methode ruft einen Verweis auf die IDeviceTopology-Schnittstelle des Gerätetopologieobjekts ab, das diesen Teil enthält.

Syntax

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

Parameter

[out] ppTopology

Zeiger auf eine Zeigervariable, in die die Methode die Adresse der IDeviceTopology-Schnittstelle des Gerätetopologieobjekts schreibt. Der Aufrufer ruft von dieser Methode einen gezählten Verweis auf die Schnittstelle ab. Mit dieser Methode erhält der Aufrufer einen gezählten Verweis auf die Schnittstelle. Der Aufrufer ist für das Freigeben der Schnittstelle verantwortlich, wenn sie nicht mehr benötigt wird, indem die Release-Methode der Schnittstelle aufgerufen wird. Wenn der GetTopologyObject-Aufruf fehlschlägt , ist *ppTopologyNULL.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, können mögliche Rückgabecodes die in der folgenden Tabelle gezeigten Werte umfassen, sind jedoch nicht darauf beschränkt.

Rückgabecode Beschreibung
E_POINTER
 Zeiger ppTopology ist NULL.

Hinweise

Codebeispiele, die diese Methode verwenden, finden Sie in den folgenden Themen:

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile devicetopology.h

Weitere Informationen

IDeviceTopology-Schnittstelle

IPart-Schnittstelle