共用方式為

IPortableDeviceContent：：GetObjectIDsFromPersistentUniqueIDs 方法 (portabledeviceapi.h)

  • 發行項

GetObjectIDsFromPersistentUniqueIDs 方法會擷取一或多個物件的目前對象標識碼，因為其持續性唯一標識符 (PUID) 。

語法

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

參數

[in] pPersistentUniqueIDs

IPortableDevicePropVariantCollection 介面的指標，該介面包含一或多個持續性唯一標識符 (PUID) 字串值， (類型VT_LPWSTR) 。

[out] ppObjectIDs

IPortableDevicePropVariantCollection 介面指標的指標，其中包含所擷取的物件標識碼，如類型VT_LPWSTR。 擷取的標識符順序會與提交的PUID相同;如果找不到值，則會以空字串表示。 呼叫端必須在完成此介面時釋放此介面。

傳回值

方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。

傳回碼 描述
S_OK
 此方法已成功。
E_POINTER
 至少有一個必要的自變數是 NULL 指標。

備註

Windows 可攜式裝置對象標識碼在裝置上是唯一的，但跨會話可能會不同。 當應用程式重新連線到裝置時，對象標識碼可能會變更。

某些應用程式，例如同步處理引擎，需要一種方式來識別聯機會話之間的物件。 每個物件都有一個WPD_OBJECT_PERSISTENT_UNIQUE_ID屬性，表示跨會話持續執行的標識碼。 應用程式可以藉由呼叫 Properties 方法，在初始會話中讀取並儲存此屬性。

範例

如需如何使用此方法的範例，請參閱 從持續性唯一標識符擷取對象標識碼

規格需求

需求 值
目標平台 Windows
標頭 portabledeviceapi.h
程式庫 PortableDeviceGUIDs.lib

另請參閱

IPortableDeviceContent 介面

從持續性唯一標識符擷取對象標識碼