Freigeben über

IEnumFullIDList::Next-Methode (shobjidl_core.h)

  • Artikel

Ruft eine angegebene Anzahl von IDLIST_ABSOLUTE Elementen ab.

Syntax

HRESULT Next(
  [in]  ULONG            celt,
  [out] PIDLIST_ABSOLUTE *rgelt,
  [out] ULONG            *pceltFetched
);

Parameter

[in] celt

Typ: ULONG

Die Anzahl der Elemente, auf die im Array verwiesen wird, auf das vom rgelt-Parameter verwiesen wird .

[out] rgelt

Typ: PIDLIST_ABSOLUTE*

Enthält bei Erfolg ein PIDL-Array. Die Implementierung muss diese Elementbezeichner mithilfe von CoTaskMemAlloc zuordnen. Die aufrufende Anwendung ist für das Freigeben der Elementbezeichner mithilfe von CoTaskMemFree verantwortlich.

[out] pceltFetched

Typ: ULONG*

Enthält bei Erfolg einen Zeiger auf einen Wert, der eine Anzahl der absoluten Elementbezeichner empfängt, die tatsächlich in rgelt zurückgegeben werden. Die Anzahl kann kleiner als der im celt-Parameter angegebene Wert sein. Dieser Parameter kann beim Eintrag nur NULL sein, wenn celt 1 ist, da die Methode in diesem Fall nur ein (S_OK) oder null (S_FALSE) Elemente abrufen kann.

Rückgabewert

Typ: HRESULT

Gibt S_OK zurück, wenn die Methode die angeforderten Celt-Elemente erfolgreich abgerufen hat. Diese Methode gibt nur S_OK zurück, wenn die vollständige Anzahl der angeforderten Elemente erfolgreich abgerufen wurde.

S_FALSE gibt an, dass mehr Elemente angefordert wurden als in der Enumeration verblieben. Der Wert, auf den der parameter pceltFetched verweist, gibt die tatsächliche Anzahl der abgerufenen Elemente an. Beachten Sie, dass der Wert 0 ist, wenn keine weiteren Elemente abgerufen werden können.

Gibt andernfalls einen COM-definierten Fehlerwert zurück.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shobjidl_core.h (einschließlich Shobjidl.h)