PeerGroupEnumMembers-Funktion (p2p.h)

Artikel
03/01/2024

Die PeerGroupEnumMembers-Funktion erstellt eine Enumeration der verfügbaren Peergruppenmitglieder und der zugehörigen Mitgliedschaftsinformationen.

Syntax

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupEnumMembers(
  [in]  HGROUP    hGroup,
  [in]  DWORD     dwFlags,
  [in]  PCWSTR    pwzIdentity,
  [out] HPEERENUM *phPeerEnum
);

Parameter

[in] hGroup

Handle für die Peergruppe, deren Mitglieder aufgelistet sind. Dieses Handle wird von der Funktion PeerGroupCreate, PeerGroupOpen oder PeerGroupJoin zurückgegeben. Dieser Parameter ist erforderlich.

[in] dwFlags

Gibt die PEER_MEMBER_FLAGS Flags an, die angeben, welche Typen von Membern in die Enumeration eingeschlossen werden sollen. Wenn dieser Wert auf 0 festgelegt ist, sind alle Mitglieder der Peergruppe enthalten.

Wert	Bedeutung
PEER_MEMBER_PRESENT	Listet alle Mitglieder der aktuellen Peergruppe auf, die online sind.

[in] pwzIdentity

Unicode-Zeichenfolge, die die Identität eines bestimmten Peers enthält, dessen Informationen in einer Einelementaufzählung abgerufen und zurückgegeben werden. Wenn dieser Parameter NULL ist, werden alle Mitglieder der aktuellen Peergruppe abgerufen. Dieser Parameter ist erforderlich.

[out] phPeerEnum

Zeiger auf die Enumeration, die die zurückgegebene Liste der Peergruppenmitglieder enthält. Dieses Handle wird an übergeben.
PeerGetNextItem , um die Elemente abzurufen, wobei jedes Element als Zeiger auf eine PEER_MEMBER-Struktur dargestellt wird. Nach Abschluss wird PeerEndEnumeration aufgerufen, um den von der Enumeration verwendeten Arbeitsspeicher zurückzugeben. Dieser Parameter ist erforderlich.

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 den angegebenen Vorgang auszuführen.
PEER_E_INVALID_GROUP	Das Handle für die Peergruppe ist ungültig.

Kryptografiespezifische Fehler können vom Microsoft RSA-Basisanbieter zurückgegeben werden. Diesen Fehlern wird CRYPT_* vorangestellt und in Winerror.h definiert.

Hinweise

Der lokale Knoten ist immer das erste Element in der Enumeration, wenn pwzIdentityNULL ist, und dwFlags ist so festgelegt, dass der lokale Knoten ein Element der expliziten Teilmenge ist.

Standardmäßig veröffentlicht jedes Mitglied Mitgliedschaftsinformationen in der Peergruppe. Wenn PEER_MEMBER_DATA_OPTIONAL für die PEER_MEMBER Daten für diesen Peer festgelegt ist, sind diese Informationen nur verfügbar, wenn ein Peer eine Aktion innerhalb der Gruppe ausführt, z. B. einen Datensatz veröffentlicht, eine Anwesenheit aktualisiert oder eine GMC ausgibt.

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

Weitere Informationen

PeerEndEnumeration

PeerGetItemCount

PeerGetNextItem

Freigeben über