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

Article
03/04/2024

La méthode SetReferences définit les références contenues dans un stockage qui contient des références (par exemple, une playlist/un album), en remplaçant toutes les références précédemment existantes contenues dans ce stockage.

Syntaxe

HRESULT SetReferences(
  [in] DWORD        dwRefs,
  [in] IMDSPStorage **ppISPStorage
);

Paramètres

[in] dwRefs

Nombre de pointeurs d’interface IMDSPStorage contenus dans le tableau passé. Zéro est une valeur acceptable et réinitialise le stockage pour qu’il contienne zéro référence. Le stockage lui-même n’est pas supprimé dans ce cas.

[in] ppISPStorage

Pointeur vers un tableau de pointeurs d’interface IMDSPStorage utilisés pour définir des références dans un stockage. Le classement des références correspond à l’ordre des pointeurs d’interface IWMDMStorage correspondants dans ce tableau. NULL est une valeur acceptable si dwRefs est également égal à zéro.

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

Tout objet IMDSPStorage valide peut être contenu dans le tableau ppIMDSPStorage . Cela inclut les dossiers et autres stockages contenant eux-mêmes des références (création, par exemple, d’une playlist de playlists).

Selon le niveau de prise en charge dans l’appareil (qu’il prenne en charge les playlists ou les playlists imbriquées), le fournisseur de services doit gérer cette méthode de manière appropriée. Si l’appareil n’a pas le niveau de prise en charge nécessaire pour le tableau de référence passé, le fournisseur de services doit retourner WMDM_E_NOTSUPPORTED.

Si la référence contient un stockage supprimé, WMDM_E_INTERFACEDEAD doit être retourné.

La méthode SetReferences suit un modèle de réinitialisation et de chargement. Les références passées incluent un ensemble complet et doivent remplacer complètement toutes les références existantes sur l’objet de stockage.

Configuration requise

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

Voir aussi

IMDSPStorage4 Interface

IMDSPStorage4 ::GetReferences

Partager via