Freigeben über


IWMDMStorage4::SetReferences-Methode (mswmdm.h)

Die SetReferences-Methode legt die Verweise fest, die in einem Speicher enthalten sind, der Verweise enthält (z. B. eine Wiedergabeliste oder ein Album), und überschreibt alle zuvor im Speicher vorhandenen Verweise.

Syntax

HRESULT SetReferences(
  [in] DWORD        dwRefs,
  [in] IWMDMStorage **ppIWMDMStorage
);

Parameter

[in] dwRefs

Anzahl der IWMDMStorage-Schnittstellenzeiger in ppIWMDMStorage. Null ist ein akzeptabler Wert und löscht alle Verweise aus dem Speicher. Der Speicher selbst wird in diesem Fall nicht gelöscht.

[in] ppIWMDMStorage

Zeiger auf ein Array von IWMDMStorage-Schnittstellenzeigern , auf die vom Speicher verwiesen werden soll. Diese Reihenfolge wird vom Speicher beibehalten. NULL ist ein akzeptabler Wert, wenn dwRefs ebenfalls null ist. Der Aufrufer ist für die Zuweisung und Freigabe dieses Arrays verantwortlich.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Alle Schnittstellenmethoden in Windows Media Geräte-Manager können eine der folgenden Klassen von Fehlercodes zurückgeben:

  • Standard-COM-Fehlercodes
  • In HRESULT-Werte konvertierte Windows-Fehlercodes
  • Windows Media Geräte-Manager Fehlercodes
Eine umfassende Liste möglicher Fehlercodes finden Sie unter Fehlercodes.

Hinweise

Diese Methode wird verwendet, um Verweise in Objekten festzulegen, die aus Verweisen bestehen, z. B. Wiedergabelisten oder Alben. Wenn ein Gerät keine Metadaten unterstützt, wird diese Methode wahrscheinlich nicht unterstützt.

Jedes gültige IWMDMStorage-Objekt kann im ppIWMDMMStorage-Array enthalten sein. Dies schließt Ordner und andere Speicher ein, die Verweise selbst angeben (z. B. eine Wiedergabeliste von Wiedergabelisten erstellen). Das Gerät selbst bestimmt, wie ein bestimmter Fall eines Referentobjekts behandelt wird. Windows Media Geräte-Manager erzwingt keine Regeln, die über die Gültigkeit von IWMDMStorage hinausgehen. Betrachten Sie den Fall einer Wiedergabeliste, die geschachtelte Wiedergabelistenverweise enthält. Auf einem Gerät ist dies nicht zulässig, und SetReferences schlägt fehl. Auf einem anderen Gerät ist dies zulässig; Die Wiedergabe durchläuft einfach den gesamten Satz enthaltener Verweise in der ersten Reihenfolge.

Die Situation kann auftreten, wenn ein IWMDMStorage4-Schnittstellenzeiger einem Speicher entspricht, der auf dem Gerät nicht mehr vorhanden ist. in diesem Fall wird WMDM_E_INTERFACEDEAD zurückgegeben.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile mswmdm.h
Bibliothek Mssachlp.lib

Weitere Informationen

Erstellen einer Wiedergabeliste auf dem Gerät

IWMDMStorage4-Schnittstelle

IWMDMStorage4::GetReferences