Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |