PeerGroupRegisterEvent-Funktion (p2p.h)

Artikel
08/25/2023

Die PeerGroupRegisterEvent-Funktion registriert einen Peer für bestimmte Peergruppenereignisse.

Syntax

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupRegisterEvent(
  [in]  HGROUP                        hGroup,
  [in]  HANDLE                        hEvent,
  [in]  DWORD                         cEventRegistration,
  [in]  PEER_GROUP_EVENT_REGISTRATION *pEventRegistrations,
  [out] HPEEREVENT                    *phPeerEvent
);

Parameter

[in] hGroup

Handle der Peergruppe, auf der die spezifischen Peerereignisse überwacht werden sollen. Dieses Handle wird von der Funktion PeerGroupCreate, PeerGroupOpen oder PeerGroupJoin zurückgegeben. Dieser Parameter ist erforderlich.

[in] hEvent

Zeiger auf ein Windows-Ereignishandle, das signalisiert wird, wenn ein Peerereignis ausgelöst wird. Wenn dieses Handle signalisiert wird, sollte der Peer PeerGroupGetEventData aufrufen, bis die Funktion PEER_S_NO_EVENT_DATA zurückgibt. Dieser Parameter ist erforderlich.

[in] cEventRegistration

Enthält die Anzahl der inpEventRegistrations aufgeführten PEER_GROUP_EVENT_REGISTRATION-Strukturen. Dieser Parameter ist erforderlich.

[in] pEventRegistrations

Zeiger auf eine Liste von PEER_GROUP_EVENT_REGISTRATION Strukturen, die die Peerereignistypen enthält, für die die Registrierung erfolgt. Dieser Parameter ist erforderlich.

[out] phPeerEvent

Zeiger auf das zurückgegebene HPEEREVENT-Handle. Ein Peer kann die Registrierung für dieses Peerereignis aufheben, indem er dieses Handle an PeerGroupUnregisterEvent übergibt. 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 verfügbar, um den Vorgang abzuschließen.
PEER_E_INVALID_GROUP	Das Handle für die Gruppe 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

Bevor Sie das HPEEREVENT-Handle schließen, müssen Sie die Registrierung für die Peerereignistypen aufheben, indem Sie das Handle an PeerGroupUnregisterEvent übergeben.

Anforderungen

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