PeerGroupRegisterEvent 関数 (p2p.h)

[アーティクル]
03/15/2023

PeerGroupRegisterEvent 関数は、特定のピアグループイベントのピアを登録します。

構文

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

パラメーター

[in] hGroup

特定のピアイベントを監視するピアグループのハンドル。このハンドルは、 PeerGroupCreate、 PeerGroupOpen、または PeerGroupJoin 関数によって返されます。このパラメーターは必須です。

[in] hEvent

ピアイベントが発生したときに通知される Windows イベントハンドルへのポインター。このハンドルがシグナル通知されると、関数がPEER_S_NO_EVENT_DATAを返すまでピアは PeerGroupGetEventData を呼び出す必要があります。このパラメーターは必須です。

[in] cEventRegistration

pEventRegistrations に一覧表示されているPEER_GROUP_EVENT_REGISTRATION構造体の数を格納します。このパラメーターは必須です。

[in] pEventRegistrations

登録が行われるピアイベントの種類を含む PEER_GROUP_EVENT_REGISTRATION 構造体のリストへのポインター。このパラメーターは必須です。

[out] phPeerEvent

返された HPEEREVENT ハンドルへのポインター。ピアは、このハンドルを PeerGroupUnregisterEvent に渡すことによって、このピアイベントの登録を解除できます。このパラメーターは必須です。

戻り値

操作 が成功した場合S_OK を返します。それ以外の場合、関数は次のいずれかの値を返します。

リターンコード	説明
E_INVALIDARG	パラメーターの 1 つが無効です。
E_OUTOFMEMORY	操作を完了するのに十分なメモリがありません。
PEER_E_INVALID_GROUP	グループへのハンドルが無効です。

暗号化固有のエラーは、 Microsoft RSA ベースプロバイダーから返すことができます。これらのエラーの前には CRYPT_* が付き、Winerror.h で定義されています。

注釈

HPEEREVENT ハンドルを閉じる前に、 PeerGroupUnregisterEvent にハンドルを渡してピアイベントの種類の登録を解除する必要があります。

要件

要件	値
サポートされている最小のクライアント	WINDOWS XP と SP2 [デスクトップアプリのみ]、Windows XP SP1 と Advanced Networking Pack forWindows XP
サポートされている最小のサーバー	サポートなし
対象プラットフォーム	Windows
ヘッダー	p2p.h
Library	P2P.lib
[DLL]	P2P.dll