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

Article
03/04/2024

La méthode FindStorage récupère un stockage dans le stockage racine actuel, en fonction de son identificateur unique persistant.

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 à rechercher.

[in] pwszUniqueID

Identificateur unique persistant du stockage à trouver. L’identificateur unique persistant du stockage est décrit par la propriété de métadonnées g_wszWMDMPersistentUniqueID du stockage.

[out] ppStorage

Pointeur vers le stockage récupéré, s’il est trouvé. L’appelant doit libérer cette interface lorsqu’il l’a terminé.

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 de codes d’erreur suivantes :

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

Cette méthode recherche uniquement un seul objet de mémoire (carte flash ou disque dur) sur l’appareil.

Un identificateur unique persistant identifie 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 des stockages différents 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.

Le format de l’identificateur unique persistant dépend de l’appareil. L’application doit avoir précédemment obtenu l’identificateur unique persistant en obtenant un stockage et en l’interrogeant pour sa propriété WMDM/PersistentUniqueID . Utilisez les méthodes GetSpecifiedMetadata ou GetMetadata pour demander cette propriété.