Méthode IWMDMStorage4 ::SetReferences (mswmdm.h)
La méthode SetReferences définit les références contenues dans un stockage qui contient des références (par exemple, une playlist ou un album), en remplaçant toutes les références précédemment existantes détenues par le stockage.
Syntaxe
HRESULT SetReferences(
[in] DWORD dwRefs,
[in] IWMDMStorage **ppIWMDMStorage
);
Paramètres
[in] dwRefs
Nombre de pointeurs d’interface IWMDMStorage dans ppIWMDMStorage. Zéro est une valeur acceptable et efface toutes les références du stockage. Le stockage lui-même n’est pas supprimé dans ce cas.
[in] ppIWMDMStorage
Pointeur vers un tableau de pointeurs d’interface IWMDMStorage à référencer par le stockage. Cet ordre est conservé par le stockage. NULL est une valeur acceptable si dwRefs est également égal à zéro. L’appelant est responsable de l’allocation et de la libération de ce tableau.
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
Remarques
Cette méthode est utilisée pour définir des références dans des objets composés de références, telles que des playlists ou des albums. Si un appareil ne prend pas en charge les métadonnées, cette méthode ne sera probablement pas prise en charge.
Tout objet IWMDMStorage valide peut être contenu dans le tableau ppIWMDMStorage . Cela inclut les dossiers et autres stockages spécifiant eux-mêmes des références (création, par exemple, d’une playlist de playlists). L’appareil lui-même détermine comment un cas particulier d’objet référence est géré. Windows Media Gestionnaire de périphériques n’applique aucune règle au-delà de celle de la validité IWMDMStorage. Prenons l’exemple d’une playlist contenant des références de playlist imbriquées. Sur un appareil, cette opération n’est pas autorisée et SetReferences échoue. Sur un autre appareil, cela est autorisé ; La lecture traverse simplement l’ensemble des références contenues dans le premier ordre de profondeur.
La situation peut se produire lorsqu’un pointeur d’interface IWMDMStorage4 correspond à un stockage qui n’existe plus sur l’appareil. WMDM_E_INTERFACEDEAD est retourné dans ce cas.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | mswmdm.h |
| Bibliothèque | Mssachlp.lib |