IPart::GetLocalId-Methode (devicetopology.h)

Artikel
02/27/2024

Die GetLocalId-Methode ruft die lokale ID dieses Teils ab.

Syntax

HRESULT GetLocalId(
  [out] UINT *pnId
);

Parameter

[out] pnId

Zeiger auf eine UINT-Variable , in die die Methode die lokale ID dieses Teils schreibt.

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	Der Zeiger pnId ist NULL.

Hinweise

Wenn Sie über einen Zeiger auf ein Teilobjekt verfügen, können Sie diese Methode aufrufen, um die lokale ID des Teils abzurufen. Eine lokale ID ist eine Zahl, die einen Teil unter allen Teilen einer Gerätetopologie eindeutig identifiziert.

Die Methoden IAudioInputSelector::GetSelection und IAudioOutputSelector::GetSelection rufen die lokale ID eines verbundenen Teils ab. Die Methoden IAudioInputSelector::SetSelection und IAudioOutputSelector::SetSelection wählen die Eingabe oder Ausgabe aus, die mit einem Teil verbunden ist, das durch seine lokale ID identifiziert wird. Die IDeviceTopology::GetPartById-Methode ruft einen Teil ab, der durch seine lokale ID identifiziert wird.

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

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