IMDSPStorage4::SetReferences-Methode (mswmdm.h)

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

Syntax

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

Parameter

[in] dwRefs

Anzahl der IMDSPStorage-Schnittstellenzeiger , die im übergebenen Array enthalten sind. Null ist ein akzeptabler Wert und setzt den Speicher auf null Verweise zurück. Der Speicher selbst wird in diesem Fall nicht gelöscht.

[in] ppISPStorage

Zeiger auf ein Array von IMDSPStorage-Schnittstellenzeigern , die zum Festlegen von Verweisen in einem Speicher verwendet werden. Die Reihenfolge der Verweise entspricht der Reihenfolge der entsprechenden IWMMMStorage-Schnittstellenzeiger in diesem Array. NULL ist ein akzeptabler Wert, wenn dwRefs ebenfalls 0 ist.

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:

• Com-Standardfehlercodes
• In HRESULT-Werte konvertierte Windows-Fehlercodes
• Windows Media Geräte-Manager Fehlercodes

Hinweise

Jedes gültige IMDSPStorage-Objekt kann im ppIMDSPStorage-Array enthalten sein. Dies schließt Ordner und andere Speicher ein, die Verweise selbst enthalten (z. B. die Erstellung einer Wiedergabeliste von Wiedergabelisten).

Abhängig von der Ebene der Unterstützung auf dem Gerät (unabhängig davon, ob Wiedergabelisten oder geschachtelte Wiedergabelisten unterstützt) sollte der Dienstanbieter diese Methode entsprechend behandeln. Wenn das Gerät nicht über die für das übergebene Verweisarray erforderliche Unterstützungsebene verfügt, sollte der Dienstanbieter WMDM_E_NOTSUPPORTED zurückgeben.

Wenn der Verweis einen gelöschten Speicher enthält, sollte WMDM_E_INTERFACEDEAD zurückgegeben werden.

Die SetReferences-Methode folgt einem Wipe-and-Load-Modell. Die übergebenen Verweise enthalten einen vollständigen Satz und sollten alle vorhandenen Verweise auf das Speicherobjekt vollständig ersetzen.

Anforderungen

Weitere Informationen

IMDSPStorage4-Schnittstelle

IMDSPStorage4::GetReferences