Método IPortableDeviceContent::GetObjectIDsFromPersistentUniqueIDs (portabledeviceapi.h)

El método GetObjectIDsFromPersistentUniqueIDs recupera el identificador de objeto actual de uno o varios objetos, dados sus identificadores únicos persistentes (PUID).

Sintaxis

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

Parámetros

[in] pPersistentUniqueIDs

Puntero a una interfaz IPortableDevicePropVariantCollection que contiene uno o varios valores de cadena de identificador único persistente (PUID) (tipo VT_LPWSTR).

[out] ppObjectIDs

Puntero a un puntero de interfaz IPortableDevicePropVariantCollection que contiene los identificadores de objeto recuperados, como tipo VT_LPWSTR. Los identificadores recuperados estarán en el mismo orden que los PUID enviados; Si no se encuentra un valor, se indica mediante una cadena vacía. El autor de la llamada debe liberar esta interfaz cuando haya terminado con ella.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.
E_POINTER	Al menos uno de los argumentos necesarios era un puntero NULL .

Comentarios

Los identificadores de objeto de dispositivos portátiles de Windows son únicos en todo el dispositivo, pero pueden ser diferentes entre sesiones. Un identificador de objeto puede cambiar cuando la aplicación se vuelve a conectar al dispositivo.

Ciertas aplicaciones, como los motores de sincronización, requieren una manera de identificar el objeto entre sesiones de conexión. Cada objeto tiene una propiedad WPD_OBJECT_PERSISTENT_UNIQUE_ID, que indica un identificador persistente entre sesiones. Las aplicaciones pueden leer y guardar esta propiedad en su sesión inicial llamando al método Properties .

Ejemplos

Para obtener un ejemplo de cómo usar este método, consulte Recuperación de un identificador de objeto de un identificador único persistente.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	portabledeviceapi.h
Library	PortableDeviceGUIDs.lib

Consulte también

IPortableDeviceContent (Interfaz)

Recuperar un identificador de objeto de un identificador único persistente