Share via

IEnumContextProps::Next-Methode (objidl.h)

  • Artikel

Ruft die angegebene Anzahl von Elementen in der Enumerationssequenz ab.

Syntax

HRESULT Next(
  [in]  ULONG           celt,
  [out] ContextProperty *pContextProperties,
  [out] ULONG           *pceltFetched
);

Parameter

[in] celt

Die Anzahl der abzurufenden Elemente. Wenn weniger als die angeforderte Anzahl von Elementen in der Sequenz vorhanden ist, ruft diese Methode die verbleibenden Elemente ab.

[out] pContextProperties

Ein Array von enumerierten Elementen.

Der Enumerator ist für die Zuweisung von Arbeitsspeicher verantwortlich, und der Aufrufer ist für die Freigabe verantwortlich. Wenn celt größer als 1 ist, muss der Aufrufer auch einen Nicht-NULL-Zeiger übergeben, der an pceltFetched übergeben wird, um zu wissen, wie viele Zeiger freigegeben werden sollen.

[out] pceltFetched

Die Anzahl der abgerufenen Elemente. Dieser Parameter ist immer kleiner oder gleich der Anzahl der angeforderten Elemente.

Rückgabewert

Wenn die -Methode die Anzahl der angeforderten Elemente abruft, wird der Rückgabewert S_OK. Andernfalls ist es S_FALSE.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile objidl.h (include ObjIdl.h)

Weitere Informationen

IEnumContextProps