MÉTHODE IMDSPDevice3::FindStorage (mswmdm.h)
La méthode FindStorage recherche un stockage avec l’identificateur unique persistant donné. L’identificateur unique persistant d’un stockage est décrit par la propriété g_wszWMDMPersistentUniqueID de ce stockage.
Syntaxe
HRESULT FindStorage(
[in] WMDM_FIND_SCOPE findScope,
[in] LPCWSTR pwszUniqueID,
[out] IMDSPStorage **ppStorage
);
Paramètres
[in] findScope
Étendue de l’opération de recherche. Il doit s’agir de l’une des valeurs suivantes.
| Valeur | Description |
|---|---|
| WMDM_FIND_SCOPE_GLOBAL | Recherchez l’ensemble de l’appareil. |
| WMDM_FIND_SCOPE_IMMEDIATE_CHILDREN | Recherchez uniquement dans les enfants immédiats du stockage actuel. |
[in] pwszUniqueID
Identificateur unique persistant du stockage.
[out] ppStorage
Pointeur vers le stockage retourné spécifié par le paramètre pwszUniqueID .
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
Notes
Le fournisseur de services retourne un identificateur unique persistant via la propriété g_wszWMDMPersistentUniqueID du stockage. Pour un stockage spécifique, l’identificateur unique persistant fourni par le fournisseur de services doit être identique entre différentes sessions de connexion d’appareil.
L’application peut appeler FindStorage avec cet identificateur unique persistant ultérieurement. En réponse, Windows Media Gestionnaire de périphériques appelle cette méthode sur le fournisseur de services (SP).
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 des stockages différents aura des identificateurs uniques persistants différents.
Windows Media Gestionnaire de périphériques appelle cette méthode uniquement pour les appareils inscrits afin d’activer la synchronisation avec Lecteur multimédia Windows. Pour plus d’informations, consultez Activation de la synchronisation avec Lecteur multimédia Windows.
Configuration requise
| Plateforme cible | Windows |
| En-tête | mswmdm.h |
| Bibliothèque | Mssachlp.lib |
Voir aussi
Activation de la synchronisation avec Lecteur multimédia Windows