通过

IPortableDeviceContent：：GetObjectIDsFromPersistentUniqueIDs 方法 (portabledeviceapi.h)

  • 项目

GetObjectIDsFromPersistentUniqueIDs 方法检索一个或多个对象的当前对象 ID，因为其持久性唯一 ID (PUID) 。

语法

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

参数

[in] pPersistentUniqueIDs

指向 IPortableDevicePropVariantCollection 接口的指针，该接口包含一个或多个持久性唯一 ID (PUID) 字符串值 (类型VT_LPWSTR) 。

[out] ppObjectIDs

指向 IPortableDevicePropVariantCollection 接口指针的指针，该指针包含检索到的对象 ID，类型 为 VT_LPWSTR。 检索到的 ID 将按与提交的 PUID 相同的顺序;如果找不到值，则由空字符串指示该值。 调用方在使用完此接口后必须释放此接口。

返回值

该方法返回 HRESULT。 可能的值包括（但并不限于）下表中的项。

返回代码 说明
S_OK
 方法成功。
E_POINTER
 至少一个必需的参数是 NULL 指针。

注解

Windows 可移植设备对象 ID 在设备中是唯一的，但在不同的会话中可能有所不同。 当应用程序重新连接到设备时，对象 ID 可能会更改。

某些应用程序（如同步引擎）需要一种方法来跨连接会话标识对象。 每个对象都有一个 WPD_OBJECT_PERSISTENT_UNIQUE_ID 属性，该属性指示在会话中永久存在的标识符。 应用程序可以通过调用 Properties 方法在其初始会话中读取和保存此属性。

示例

有关如何使用此方法的示例，请参阅 从持久唯一标识符检索对象标识符

要求

要求 值
目标平台 Windows
标头 portabledeviceapi.h
Library PortableDeviceGUIDs.lib

另请参阅

IPortableDeviceContent 接口

从持久唯一标识符检索对象标识符