Share via

IConnector::GetConnectorIdConnectedTo-Methode (devicetopology.h)

  • Artikel

Die GetConnectorIdConnectedTo-Methode ruft die globale ID des Connectors ab, sofern vorhanden, mit dem dieser Connector verbunden ist.

Syntax

HRESULT GetConnectorIdConnectedTo(
  [out] LPWSTR *ppwstrConnectorId
);

Parameter

[out] ppwstrConnectorId

Zeiger auf einen Zeichenfolgenzeiger, in den die -Methode die Adresse einer mit NULL beendeten breitzeichenigen Zeichenfolge schreibt, die die globale ID des anderen Connectors enthält. Die -Methode weist den Speicher für die Zeichenfolge zu. Der Aufrufer ist für das Freigeben des Speichers verantwortlich, wenn er nicht mehr benötigt wird, indem er die CoTaskMemFree-Funktion aufruft . Wenn der Aufruf GetConnectorIdConnectedTo fehlschlägt , ist *ppwstrConnectorIdNULL. Informationen zu CoTaskMemFree finden Sie in der Dokumentation zum Windows SDK.

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_NOTFOUND
 Dieser Connector ist nicht verbunden, oder die andere Seite der Verbindung ist keine andere Gerätetopologie (z. B. eine Software_IO Verbindung).
E_POINTER
 Der Parameter ppwstrConnectorId ist NULL.
E_OUTOFMEMORY
 Nicht genügend Arbeitsspeicher.

Hinweise

Eine globale ID ist eine Zeichenfolge, die einen Teil zwischen allen Teilen in allen Gerätetopologien im System eindeutig identifiziert. Clients sollten diese Zeichenfolge als undurchsichtig behandeln. Das heißt, Clients sollten nicht versuchen, den Inhalt der Zeichenfolge zu analysieren, um Informationen über das Teil abzurufen. Der Grund ist, dass das Zeichenfolgenformat nicht definiert ist und sich möglicherweise von einer Implementierung der DeviceTopology-API zur nächsten ändert.

Anforderungen

Anforderung Wert
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

IConnector-Schnittstelle