PeerGetNextItem-Funktion (p2p.h)

Artikel
03/01/2024

Die PeerGetNextItem-Funktion gibt eine bestimmte Anzahl von Elementen aus einer Peeraufzählung zurück.

Syntax

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGetNextItem(
  [in]      HPEERENUM hPeerEnum,
  [in, out] ULONG     *pCount,
  [out]     PVOID     **pppvItems
);

Parameter

[in] hPeerEnum

Handle mit der Peeraufzählung, aus der Elemente abgerufen werden. Dieses Handle wird von einer Peeraufzählungsfunktion generiert.

[in, out] pCount

Zeiger auf eine ganze Zahl, die die Anzahl der Elemente angibt, die aus der Peeraufzählung abgerufen werden sollen. Wenn es zurückgegeben wird, enthält es die Anzahl der Elemente in ppvItems. Dieser Parameter darf nicht NULL sein.

[out] pppvItems

Empfängt einen Zeiger auf ein Array von Zeigern auf die nächsten pCount-Elemente in der Peeraufzählung. Die Daten, z. B. ein Datensatz oder Memberinformationsblock, hängen vom tatsächlichen Peeraufzählungstyp ab.

Rückgabewert

Gibt S_OK zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt die Funktion einen der folgenden Werte zurück.

Rückgabecode	Beschreibung
E_INVALIDARG	Einer der Parameter ist ungültig.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher vorhanden, um einen angegebenen Vorgang auszuführen.

Hinweise

Die PeerGetNextItem-Funktion gibt Folgendes zurück:

Elemente, die gleich oder kleiner als der in pCount angegebene Betrag sind.
Eine Liste von Elementen, die kleiner als der angegebene Betrag sind, wenn der Betrag größer als die Anzahl der verfügbaren Elemente ist.

Hinweis Wenn beispielsweise der eingehende Wert von pCount 10 und der Rest der Enumeration 5 Elemente ist, werden nur 5 Elemente zurückgegeben, und der Wert, auf den pCount verweist, wird auf 5 festgelegt.

Alle zurückgegebenen Elemente müssen durch Übergeben eines Zeigers an das Array von Zeigern an die PeerFreeData-Funktion freigegeben werden.

Das Ende einer Enumeration wird angegeben, wenn die Funktion mit dem pCount-Parameter auf null (0) zurückgibt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP mit SP2 [nur Desktop-Apps],Windows XP mit SP1 mit dem Advanced Networking Pack forWindows XP
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	p2p.h
Bibliothek	P2P.lib
DLL	P2P.dll