IEnumConnections::Next-Methode (ocidl.h)

  • Artikel

Ruft die angegebene Anzahl von Elementen in der Enumerationssequenz ab.

Syntax

HRESULT Next(
  [in]  ULONG         cConnections,
  [out] LPCONNECTDATA rgcd,
  [out] ULONG         *pcFetched
);

Parameter

[in] cConnections

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

[out] rgcd

Ein Array von aufgezählten 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] pcFetched

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 wird sie S_FALSE.

Hinweise

Nachdem diese Methode erfolgreich zurückgegeben wurde, ist der Aufrufer für das Aufrufen von Release (siehe pUnk-Member von CONNECTDATA) für jedes Element im Array verantwortlich. Wenn cConnections größer als eins ist, muss der Aufrufer auch einen Nicht-NULL-Zeiger an lpcFetched übergeben, um die Anzahl der Zeiger abzurufen, die freigegeben werden müssen.

E_NOTIMPL ist als Rückgabewert nicht zulässig. Wenn ein Fehlerwert zurückgegeben wird, sind beim Beenden keine Einträge im Array gültig, und daher ist kein Release erforderlich.

Anforderungen

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

Weitere Informationen

CONNECTDATA

IEnumConnections