Metodo IPortableDeviceContent::GetObjectIDsFromPersistentUniqueIDs (portabledeviceapi.h)

Il metodo GetObjectIDsFromPersistentUniqueIDs recupera l'ID oggetto corrente di uno o più oggetti, in base ai relativi ID univoci permanenti (PUID).

Sintassi

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

Parametri

[in] pPersistentUniqueIDs

Puntatore a un'interfaccia IPortableDevicePropVariantCollection che contiene uno o più valori stringa ID univoco permanente (PUID) (tipo VT_LPWSTR).

[out] ppObjectIDs

Puntatore a un puntatore all'interfaccia IPortableDevicePropVariantCollection che contiene gli ID oggetto recuperati, come tipo VT_LPWSTR. Gli ID recuperati saranno nello stesso ordine dei PUID inviati; se non è stato possibile trovare un valore, viene indicato da una stringa vuota. Il chiamante deve rilasciare questa interfaccia al termine dell'operazione.

Valore restituito

Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Commenti

Gli ID oggetto dispositivi portatili Windows sono univoci nel dispositivo, ma possono essere diversi tra le sessioni. Un ID oggetto può cambiare quando l'applicazione si riconnette al dispositivo.

Alcune applicazioni, ad esempio i motori di sincronizzazione, richiedono un modo per identificare l'oggetto tra le sessioni di connessione. Ogni oggetto ha una proprietà WPD_OBJECT_PERSISTENT_UNIQUE_ID, che indica un identificatore persistente tra le sessioni. Le applicazioni possono leggere e salvare questa proprietà nella sessione iniziale chiamando il metodo Properties .

Esempio

Per un esempio di come usare questo metodo, vedere Recupero di un identificatore di oggetto da un identificatore univoco persistente

Requisiti

Vedi anche

Interfaccia IPortableDeviceContent

Recupero di un identificatore di oggetto da un identificatore univoco permanente