MÉTHODE IMDSPStorage4 ::FindStorage (mswmdm.h)

Article
03/04/2024

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

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

Remarques

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 le même 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.

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.

Cette méthode permet de rechercher un stockage basé sur un identificateur unique persistant, tandis que IMDSPStorage2 ::GetStorage permet de rechercher un stockage basé sur le nom.

Windows Media Gestionnaire de périphériques appelle cette méthode uniquement pour les appareils qui peuvent être synchronisés avec Lecteur multimédia Windows. Pour plus d’informations, consultez Activation de la synchronisation avec Lecteur multimédia Windows.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	mswmdm.h
Bibliothèque	Mssachlp.lib

Voir aussi

Activation de la synchronisation avec Lecteur multimédia Windows

IMDSPStorage2 ::GetStorage

IMDSPStorage4 Interface

Partager via