PeerCollabRegisterEvent 函数 (p2p.h)
PeerCollabRegisterEvent 函数向对等协作基础结构注册应用程序,以接收特定对等协作事件的回调。
语法
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabRegisterEvent(
[in] HANDLE hEvent,
[in] DWORD cEventRegistration,
[in] PEER_COLLAB_EVENT_REGISTRATION *pEventRegistrations,
[out] HPEEREVENT *phPeerEvent
);
参数
[in] hEvent
由 CreateEvent 创建的句柄,该句柄在触发事件时向应用程序发出信号。 当应用程序收到信号时,它必须调用 PeerCollabGetEventData 来检索事件,直到返回PEER_S_NO_EVENT_DATA。
[in] cEventRegistration
pEventRegistrations 中的PEER_COLLAB_EVENT_REGISTRATION结构数。
[in] pEventRegistrations
一个PEER_COLLAB_EVENT_REGISTRATION结构的数组,这些结构指定应用程序请求通知的对等协作事件。
[out] phPeerEvent
此函数返回的对等事件句柄。 当对等方上引发对等协作网络事件时,此句柄将传递给 PeerCollabGetEventData 。
返回值
如果函数成功,则返回S_OK。 否则,函数将返回以下值之一。
返回代码 | 说明 |
---|---|
|
没有足够的内存来支持此操作。 |
|
其中一个参数无效。 |
|
尝试从提升的进程调用 PeerCollabRegisterEvent 。 |
|
Windows 对等基础结构未初始化。 需要调用相关的初始化函数。 |
注解
如果 p2phost.exe 服务未运行,则此函数将尝试为需要 p2phost 的注册启动它。
如果尝试从提升的进程启动 p2phost.exe,则返回错误。 因此,错误地向 p2phost.exe 授予管理权限的应用程序不会损害安全性。 无法在非交互模式下启动 p2phost.exe,因为它需要显示传入邀请的 Windows 对话框。
在承受较大压力的计算机上调用 PeerCollabRegisterEvent 时,函数可能会返回PEER_E_SERVICE_NOT_AVAILABLE错误代码。
应用程序可以多次调用 PeerCollabRegisterEvent ,其中每个调用被视为单独的注册。 多次注册事件时,每个注册都会收到该事件的副本。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | 无受支持的版本 |
目标平台 | Windows |
标头 | p2p.h |
Library | P2P.lib |
DLL | P2P.dll |
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈