PeerGraphRegisterEvent 関数 (p2p.h)
PeerGraphRegisterEvent 関数は、ピア グラフとイベントの種類に関連付けられた変更の通知を受け取るピアの要求を登録します。
構文
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphRegisterEvent(
[in] HGRAPH hGraph,
[in] HANDLE hEvent,
[in] ULONG cEventRegistrations,
[in] PEER_GRAPH_EVENT_REGISTRATION *pEventRegistrations,
[out] HPEEREVENT *phPeerEvent
);
パラメーター
[in] hGraph
ピア グラフへのハンドル。
[in] hEvent
イベントがトリガーされたときにアプリケーションが通知される CreateEvent によって作成されたハンドル。 アプリケーションが通知されたら、 PeerGraphGetEventData を呼び出して、PEER_S_NO_EVENT_DATA返されるまでイベントを取得する必要があります。
[in] cEventRegistrations
pEventRegistrations 内のPEER_GRAPH_EVENT_REGISTRATION構造体の数を指定します。
[in] pEventRegistrations
アプリケーションが通知を要求するイベントを指定する PEER_GRAPH_EVENT_REGISTRATION 構造体の配列を指します。
[out] phPeerEvent
HPEEREVENT ハンドルを受け取ります。 このハンドルは、 PeerGraphUnregisterEvent を呼び出して通知の受信を停止するときに使用する必要があります。
戻り値
関数呼び出しが成功した場合、戻り値はS_OK。 それ以外の場合は、次のいずれかの値を返します。
リターン コード | 説明 |
---|---|
|
パラメーターの 1 つが無効です。 |
|
指定した操作を実行するのに十分なメモリがありません。 |
|
ピア グラフへのハンドルが無効です。 |
|
この関数を使用する前に、ピア グラフを PeerGraphStartup の呼び出しで初期化する必要があります。 |
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | WINDOWS XP と SP2 [デスクトップ アプリのみ]、Windows XP SP1 と Advanced Networking Pack forWindows XP |
サポートされている最小のサーバー | サポートなし |
対象プラットフォーム | Windows |
ヘッダー | p2p.h |
Library | P2PGraph.lib |
[DLL] | P2PGraph.dll |