IEnumBstr::Next-Methode (tapi3if.h)

Artikel
03/09/2024

Die Next-Methode ruft die nächste angegebene Anzahl von Elementen in der Enumerationssequenz ab. Diese Methode ist für Visual Basic- und Skriptsprachen ausgeblendet.

Syntax

HRESULT Next(
  [in]      ULONG celt,
  [out]     BSTR  *ppStrings,
  [in, out] ULONG *pceltFetched
);

Parameter

[in] celt

Anzahl der angeforderten Elemente.

[out] ppStrings

Zeiger auf die Liste der zurückgegebenen BSTR-Zeiger .

[in, out] pceltFetched

Zeiger auf die Anzahl der tatsächlich bereitgestellten Elemente. Kann NULL sein, wenn celt eins ist.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode hat die Anzahl der Elemente zurückgegeben.
S_FALSE	Die Anzahl der verbleibenden Elemente war kleiner als celt.
E_POINTER	Der ppStrings-Parameter ist kein gültiger Zeiger.

Hinweise

Die Anwendung muss SysFreeString verwenden, um den für den ppStrings-Parameter zugewiesenen Arbeitsspeicher freizugeben.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	tapi3if.h (einschließlich Tapi3.h)
Bibliothek	Uuid.lib
DLL	Tapi3.dll

Freigeben über