Метод IPortableDeviceContent::GetObjectIDsFromPersistentUniqueIDs (portabledeviceapi.h)

Статья
03/01/2024

Метод GetObjectIDsFromPersistentUniqueIDs извлекает текущий идентификатор одного или нескольких объектов с учетом их постоянных уникальных идентификаторов (PUID).

Синтаксис

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

Параметры

[in] pPersistentUniqueIDs

Указатель на интерфейс IPortableDevicePropVariantCollection , содержащий одно или несколько строковых значений постоянного уникального идентификатора (ТИП VT_LPWSTR).

[out] ppObjectIDs

Указатель на интерфейс IPortableDevicePropVariantCollection , содержащий извлеченные идентификаторы объектов, как тип VT_LPWSTR. Полученные идентификаторы будут находиться в том же порядке, что и отправленные PUID; Если не удается найти значение, оно обозначается пустой строкой. Вызывающий объект должен освободить этот интерфейс после завершения работы с ним.

Возвращаемое значение

Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Код возврата	Описание
S_OK	Метод выполнен успешно.
E_POINTER	По крайней мере один из обязательных аргументов был указателем NULL .

Идентификаторы объектов переносимых устройств Windows уникальны на устройстве, но могут отличаться в разных сеансах. Идентификатор объекта может измениться при повторном подключении приложения к устройству.

Для некоторых приложений, таких как механизмы синхронизации, требуется способ идентификации объекта в сеансах подключения. У каждого объекта есть свойство WPD_OBJECT_PERSISTENT_UNIQUE_ID, которое указывает идентификатор, сохраняемый в сеансах. Приложения могут считывать и сохранять это свойство в своем первоначальном сеансе, вызывая метод Properties .

Примеры

Пример использования этого метода см. в разделе Извлечение идентификатора объекта из постоянного уникального идентификатора.

Требования

Требование	Значение
Целевая платформа	Windows
Header	portabledeviceapi.h
Библиотека	PortableDeviceGUIDs.lib

См. также раздел

Интерфейс IPortableDeviceContent

Получение идентификатора объекта из постоянного уникального идентификатора

Поделиться через