Méthode IWMDMDevice3 ::FindStorage (mswmdm.h)

Article
02/29/2024

La méthode FindStorage recherche un stockage par son identificateur unique persistant. Contrairement à d’autres méthodes, cette méthode peut effectuer des recherches récursives à partir du stockage racine.

Syntaxe

HRESULT FindStorage(
  [in]  WMDM_FIND_SCOPE findScope,
  [in]  LPCWSTR         pwszUniqueID,
  [out] IWMDMStorage    **ppStorage
);

Paramètres

[in] findScope

Énumération WMDM_FIND_SCOPE spécifiant l’étendue de l’opération de recherche.

[in] pwszUniqueID

Chaîne à caractère large, terminée par null représentant un identificateur unique persistant du stockage, qui peut être récupérée en interrogeant la propriété g_wszWMDMPersistentUniqueID du stockage.

[out] ppStorage

Pointeur vers le stockage retourné. L’appelant doit libérer cette interface lorsqu’elle est terminée.

Valeur retournée

Cette méthode retourne un code HRESULT. Toutes les méthodes d’interface dans Windows Media Gestionnaire de périphériques peuvent retourner l’une des classes suivantes de codes d’erreur :

Codes d’erreur COM standard
Codes d’erreur Windows convertis en valeurs HRESULT
Codes d’erreur Gestionnaire de périphériques Windows Media

Pour obtenir une liste complète des codes d’erreur possibles, consultez Codes d’erreur.

Remarques

Un identificateur unique persistant est utilisé pour identifier de manière unique le contenu stocké sur un appareil particulier. Il ne représente pas un identificateur global unique spécifique au contenu qui reste identique sur tous les appareils. Ainsi, le même contenu stocké dans différents stockages aura des identificateurs uniques persistants différents. De même, un contenu différent peut avoir le même identificateur unique persistant lorsqu’il est stocké sur différents appareils. En utilisant l’analogie du contenu sur un appareil similaire aux lignes d’une base de données, cette propriété a le même rôle que la colonne d’identité dans une base de données.

Étant donné qu’il est généré par l’appareil, le format de l’identificateur unique persistant dépend de l’appareil. L’application doit obtenir l’identificateur unique persistant en interrogeant la propriété g_wszWMDMPersistentUniqueID du stockage. Une application peut utiliser les méthodes GetSpecifiedMetadata ou GetMetadata pour interroger cette propriété.