PeerGraphRegisterEvent-Funktion (p2p.h)

Artikel
03/04/2024

Die PeerGraphRegisterEvent-Funktion registriert die Anforderung eines Peers, um über Änderungen benachrichtigt zu werden, die einem Peerdiagramm und ereignistyp zugeordnet sind.

Syntax

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphRegisterEvent(
  [in]  HGRAPH                        hGraph,
  [in]  HANDLE                        hEvent,
  [in]  ULONG                         cEventRegistrations,
  [in]  PEER_GRAPH_EVENT_REGISTRATION *pEventRegistrations,
  [out] HPEEREVENT                    *phPeerEvent
);

Parameter

[in] hGraph

Handle mit dem Peerdiagramm.

[in] hEvent

Von CreateEvent erstelltes Handle, für das die Anwendung signalisiert wird, wenn ein Ereignis ausgelöst wird. Wenn eine Anwendung signalisiert wird, muss sie PeerGraphGetEventData aufrufen, um Ereignisse abzurufen, bis PEER_S_NO_EVENT_DATA zurückgegeben wird.

[in] cEventRegistrations

Gibt die Anzahl PEER_GRAPH_EVENT_REGISTRATION Strukturen in pEventRegistrations an.

[in] pEventRegistrations

Zeigt auf ein Array von PEER_GRAPH_EVENT_REGISTRATION Strukturen, die angeben, für welche Ereignisse die Anwendung Benachrichtigungen anfordert.

[out] phPeerEvent

Empfängt ein HPEEREVENT-Handle . Dieses Handle muss beim Aufrufen von PeerGraphUnregisterEvent verwendet werden, um den Empfang von Benachrichtigungen zu beenden.

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	Einer der Parameter ist ungültig.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher vorhanden, um den angegebenen Vorgang auszuführen.
PEER_E_INVALID_GRAPH	Das Handle für das Peerdiagramm ist ungültig.
PEER_E_NOT_INITIALIZED	Das Peerdiagramm muss mit einem Aufruf von PeerGraphStartup initialisiert werden, bevor diese Funktion verwendet wird.

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

Weitere Informationen

PEER_GRAPH_EVENT_REGISTRATION

PeerGraphGetEventData

PeerGraphUnregisterEvent

Freigeben über