IMDSPEnumStorage::Next-Methode (mswmdm.h)

Artikel
08/25/2023

Die Next-Methode gibt einen Zeiger auf die nächste celtIMDSPStorage-Schnittstelle zurück.

Syntax

HRESULT Next(
  [in]  ULONG        celt,
  [out] IMDSPStorage **ppStorage,
  [out] ULONG        *pceltFetched
);

Parameter

[in] celt

Anzahl der angeforderten Speicherschnittstellen.

[out] ppStorage

Array von CeltIMDSPStorage-Schnittstellenzeigern , die vom Aufrufer zugeordnet werden. Gibt NULL zurück, wenn keine Speichermedien mehr vorhanden sind oder ein Fehler aufgetreten ist. Wenn celt mehr als 1 ist, muss der Aufrufer genügend Arbeitsspeicher zuweisen, um die Anzahl der Schnittstellenzeiger zu speichern.

[out] pceltFetched

Zeiger auf eine ULONG-Variable , die die Anzahl der zurückgegebenen Schnittstellen empfängt.

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

Wenn keine Speicherschnittstellen mehr vorhanden sind oder weniger Speicherschnittstellen als angefordert vorhanden sind, ist der Rückgabewert von Weiter S_FALSE. In diesem Fall muss der parameter pceltFetched abgefragt werden, um zu bestimmen, wie viele Schnittstellen (falls vorhanden) zurückgegeben wurden.

Der Speicherenumerator spiegelt möglicherweise nicht den Effekt des Einfügens und Entfernens von Medien wider. In solchen Fällen sollte der Client ein neues Enumeratorobjekt abrufen.

Diese Methode muss implementiert werden. Es darf keine WMDM_E_NOTSUPPORTED oder E_NOTIMPL zurückgeben. Weitere Informationen finden Sie unter Obligatorische und optionale Schnittstellen.