PeerGraphGetEventData-Funktion (p2p.h)

Die PeerGraphGetEventData-Funktion ruft Peerereignisse ab. Eine Anwendung ruft diese Funktion auf, bis der Rückgabewert PEER_S_NO_EVENT_DATA zurückgegeben wird, was angibt, dass ein Aufruf erfolgreich ist, aber keine Peerereignisse mehr abgerufen werden können.

Syntax

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphGetEventData(
  [in]  HPEEREVENT             hPeerEvent,
  [out] PPEER_GRAPH_EVENT_DATA *ppEventData
);

Parameter

[in] hPeerEvent

Peerereignishandle, das durch einen Aufruf von PeerGraphRegisterEvent abgerufen wurde.

[out] ppEventData

Empfängt einen Zeiger auf eine PEER_GRAPH_EVENT_DATA Struktur, die die Daten zu einer Ereignisbenachrichtigung enthält. Wenn diese Struktur nicht benötigt wird, geben Sie sie durch Aufrufen von PeerGraphFreeData frei.

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	Ein Parameter ist ungültig.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher vorhanden, um einen angegebenen Vorgang auszuführen.
PEER_S_NO_EVENT_DATA	Der Funktionsaufruf ist erfolgreich, aber einem Peerereignis sind keine Daten zugeordnet.
PEER_E_NOT_INITIALIZED	Ein Peergraph muss mit einem Aufruf von PeerGraphStartup initialisiert werden, bevor diese Funktion verwendet wird.

Hinweise

Peerereignisdaten werden in einer PEER_GRAPH_EVENT_DATA-Struktur zurückgegeben. Der Typ der Datenstruktur, auf die PEER_GRAPH_EVENT_DATA verweist, hängt davon ab, welches Ereignis ausgelöst wird.

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	P2PGraph.lib
DLL	P2PGraph.dll

Weitere Informationen

PEER_GRAPH_EVENT_DATA

PeerGraphFreeData

PeerGraphRegisterEvent

PeerGraphUnregisterEvent