PeerGraphRegisterEvent-Funktion (p2p.h)
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 |
---|---|
|
Einer der Parameter ist ungültig. |
|
Es ist nicht genügend Arbeitsspeicher vorhanden, um den angegebenen Vorgang auszuführen. |
|
Das Handle für das Peerdiagramm ist ungültig. |
|
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 |