IMDSPStorage4::GetReferences-Methode (mswmdm.h)

Die GetReferences-Methode gibt ein Array von Zeigern auf IMDSPStorage-Objekte zurück, die die in einem Zuordnungsspeicher enthaltenen Verweise enthalten, z. B. ein Array, das Wiedergabelisten- oder Albumobjekte darstellt.

Syntax

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

Parameter

[out] pdwRefs

Zeiger auf die Anzahl der IWMDMStorage-Schnittstellenzeiger , die in pppIWMDMStorage zurückgegeben werden.

[out] pppISPStorage

Zeiger auf einen Zeiger auf das Array von IWMDMStorage-Schnittstellenzeigern , die Verweise auf einen Speicher darstellen. Solche Verweise können beispielsweise Elemente in einer Wiedergabeliste oder einem Album darstellen. Die Reihenfolge der Verweise entspricht der Reihenfolge in diesem Array. Der Arbeitsspeicher für dieses Array sollte vom Dienstanbieter zugewiesen werden.

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

Windows Media Geräte-Manager verwendet diese Methode zum Abrufen der Verweise auf einen Zuordnungsspeicher, z. B. eine Wiedergabeliste oder ein Album.

Wenn der Speicher Verweise auf ein oder mehrere Elemente enthält, die vom Gerät gelöscht wurden, sollte der SP diese Verweise nicht in die zurückgegebenen Verweise aufnehmen. Der SP sollte eine solche Bedingung angeben, indem S_FALSE zurückgegeben wird. Die Anwendung kann sich dafür entscheiden, das Zuordnungsspeicherobjekt mithilfe der hier zurückgegebenen verweise zu aktualisieren. Der SP kann auch die Verweise selbst aktualisieren.

Wenn die Anzahl der Verweise 0 ist, muss der Dienstanbieter ein Array von Verweisen mit 0 Elementen zurückgeben.

Anforderungen

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

Weitere Informationen

IMDSPStorage4-Schnittstelle

IMDSPStorage4::SetReferences