PeerEnumGroups-Funktion (p2p.h)
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 |
|---|---|
|
Einer der Parameter ist ungültig. |
|
Es ist nicht genügend Arbeitsspeicher vorhanden, um den angegebenen Vorgang auszuführen. |
|
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 |