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

La méthode GetObjectIDsFromPersistentUniqueIDs récupère l’ID d’objet actuel d’un ou de plusieurs objets, compte tenu de leurs ID uniques (PUID) persistants.

Syntaxe

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

Paramètres

[in] pPersistentUniqueIDs

Pointeur vers une interface IPortableDevicePropVariantCollection qui contient une ou plusieurs valeurs de chaîne d’ID unique (PUID) persistantes (type VT_LPWSTR).

[out] ppObjectIDs

Pointeur vers un pointeur d’interface IPortableDevicePropVariantCollection qui contient les ID d’objet récupérés, comme type VT_LPWSTR. Les ID récupérés seront dans le même ordre que les PUID envoyés ; si une valeur est introuvable, elle est indiquée par une chaîne vide. L’appelant doit libérer cette interface lorsqu’il l’a terminé.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Remarques

Les ID d’objet des appareils portables Windows sont uniques sur l’appareil, mais peuvent être différents d’une session à l’autre. Un ID d’objet peut changer lorsque l’application se reconnecte à l’appareil.

Certaines applications, telles que les moteurs de synchronisation, nécessitent un moyen d’identifier l’objet entre les sessions de connexion. Chaque objet a une propriété WPD_OBJECT_PERSISTENT_UNIQUE_ID, qui indique un identificateur persistant entre les sessions. Les applications peuvent lire et enregistrer cette propriété dans leur session initiale, en appelant la méthode Properties .

Exemples

Pour obtenir un exemple d’utilisation de cette méthode, consultez Récupération d’un identificateur d’objet à partir d’un identificateur unique persistant.

Configuration requise

Voir aussi

IPortableDeviceContent, interface

Récupération d’un identificateur d’objet à partir d’un identificateur unique persistant