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

La méthode GetReferences retourne un tableau de pointeurs vers des objets IMDSPStorage comprenant les références contenues dans un stockage d’association, comme un représentant des objets de playlist ou d’album.

Syntaxe

HRESULT GetReferences(
  [out] DWORD        *pdwRefs,
  [out] IMDSPStorage ***pppISPStorage
);

Paramètres

[out] pdwRefs

Pointeur vers le nombre de pointeurs d’interface IWMDMStorage retournés dans pppIWMDMStorage.

[out] pppISPStorage

Pointeur vers un pointeur vers le tableau de pointeurs d’interface IWMDMStorage qui représentent des références sur un stockage. Ces références peuvent, par exemple, représenter des éléments d’une playlist ou d’un album. L’ordre des références correspond au classement dans ce tableau. La mémoire pour ce tableau doit être allouée par le fournisseur de services.

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

Remarques

Windows Media Gestionnaire de périphériques utilise cette méthode pour obtenir les références sur un stockage d’association tel qu’une playlist ou un album.

Si le stockage contient des références à un ou plusieurs éléments qui ont été supprimés de l’appareil, le fournisseur de services ne doit pas inclure ces références dans les références retournées. Le fournisseur de services doit indiquer cette condition en retournant S_FALSE. L’application peut choisir d’actualiser l’objet de stockage d’association à l’aide des références dont le nombre a été correct et qui ont été renvoyés ici. Le fournisseur de services peut également actualiser les références lui-même.

Si le nombre de références est 0, le fournisseur de services doit retourner un tableau de références contenant 0 éléments.

Configuration requise

Voir aussi

IMDSPStorage4 Interface

IMDSPStorage4 ::SetReferences