IPortableDeviceContent::GetObjectIDsFromPersistentUniqueIDs-Methode (portabledeviceapi.h)

Artikel
08/25/2023

Die GetObjectIDsFromPersistentUniqueIDs-Methode ruft die aktuelle Objekt-ID eines oder mehrerer Objekte ab, da ihre persistenten eindeutigen IDs (PUIDs) angegeben sind.

Syntax

HRESULT GetObjectIDsFromPersistentUniqueIDs(
  [in]  IPortableDevicePropVariantCollection *pPersistentUniqueIDs,
  [out] IPortableDevicePropVariantCollection **ppObjectIDs
);

Parameter

[in] pPersistentUniqueIDs

Zeiger auf eine IPortableDevicePropVariantCollection-Schnittstelle , die einen oder mehrere PUID-Zeichenfolgenwerte (Persistent Unique ID) enthält (Typ VT_LPWSTR).

[out] ppObjectIDs

Zeiger auf einen IPortableDevicePropVariantCollection-Schnittstellenzeiger , der die abgerufenen Objekt-IDs als Typ VT_LPWSTR enthält. Die abgerufenen IDs befinden sich in der gleichen Reihenfolge wie die übermittelten PUIDs. wenn ein Wert nicht gefunden werden konnte, wird er durch eine leere Zeichenfolge angegeben. Der Aufrufer muss diese Schnittstelle freigeben, wenn sie damit fertig ist.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_POINTER	Mindestens eines der erforderlichen Argumente war ein NULL-Zeiger .

Hinweise

Windows Portable Devices-Objekt-IDs sind auf dem Gerät eindeutig, können sich jedoch von Sitzungssitzungen unterscheiden. Eine Objekt-ID kann sich ändern, wenn die Anwendung wieder eine Verbindung mit dem Gerät hergestellt hat.

Bestimmte Anwendungen, z. B. Synchronisierungs-Engines, erfordern eine Möglichkeit, das Objekt über Verbindungssitzungen hinweg zu identifizieren. Jedes Objekt verfügt über eine WPD_OBJECT_PERSISTENT_UNIQUE_ID-Eigenschaft, die einen Bezeichner angibt, der sitzungsübergreifend persistent ist. Anwendungen können diese Eigenschaft in ihrer ersten Sitzung lesen und speichern, indem sie die Properties-Methode aufrufen.

Beispiele

Ein Beispiel für die Verwendung dieser Methode finden Sie unter Abrufen eines Objektbezeichners aus einem persistenten eindeutigen Bezeichner.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	portabledeviceapi.h
Bibliothek	PortableDeviceGUIDs.lib

Weitere Informationen

IPortableDeviceContent-Schnittstelle

Abrufen eines Objektbezeichners aus einem persistenten eindeutigen Bezeichner

Freigeben über