PeerEnumGroups-Funktion (p2p.h)

Artikel
03/01/2024

Die PeerEnumGroups-Funktion erstellt und gibt ein Peerenumumerhandle zurück, das zum Aufzählen aller Peergruppen verwendet wird, die einer bestimmten Peeridentität zugeordnet sind.

Syntax

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerEnumGroups(
  [in]  PCWSTR    pwzIdentity,
  [out] HPEERENUM *phPeerEnum
);

Parameter

[in] pwzIdentity

Gibt die Peeridentität an, für die Gruppen aufgezählt werden sollen.

[out] phPeerEnum

Empfängt ein Handle für die Peeraufzählung, das die Liste der Peergruppen enthält, deren Mitglied die angegebene Identität ist, wobei jedes Element als Zeiger auf eine PEER_NAME_PAIR-Struktur dargestellt wird. Übergeben Sie dieses Handle an PeerGetNextItem , um die Elemente abzurufen. Wenn Sie fertig sind, rufen Sie PeerEndEnumeration auf, um den Arbeitsspeicher freizugeben.

Rückgabewert

Wenn der Funktionsaufruf erfolgreich ist, wird der Rückgabewert S_OK. Andernfalls wird einer der folgenden Werte zurückgegeben.

Rückgabecode	Beschreibung
E_INVALIDARG	Einer der Parameter ist ungültig.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher vorhanden, um den angegebenen Vorgang auszuführen.
PEER_E_NOT_FOUND	Die angegebene Peeridentität wurde nicht gefunden.

Hinweise

Nachdem die Anwendung das Enumerationshandle abgerufen hat, verwenden Sie PeerGetNextItem und PeerGetItemCount , um die Peergruppen aufzulisten.

Beim Auflisten von Peergruppen gibt PeerGetNextItem ein Array von Zeigern auf PEER_NAME_PAIR Strukturen zurück.

Rufen Sie PeerEndEnumeration auf, um das Handle für die Peerenumeration frei zu geben, wenn es nicht mehr benötigt wird.

Anforderungen

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

Weitere Informationen