PeerCollabSignin 函数 (p2p.h)

PeerCollabSignin 函数将对等互连签名到托管的 Internet (无服务器状态) 或子网 (“人员 Near Me”) 对等协作网络状态提供程序。

语法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabSignin(
  [in] HWND  hwndParent,
  [in] DWORD dwSigninOptions
);

[in] hwndParent

父应用程序登录的 Windows 句柄。

[in] dwSigninOptions

PEER_SIGNIN_FLAGS 枚举值，该值包含调用对等方的状态提供程序登录选项。

如果函数成功，则返回S_OK。否则，函数将返回以下值之一。

返回代码	说明
E_OUTOFMEMORY	没有足够的内存来支持此操作。
E_INVALIDARG	其中一个参数无效。
PEER_E_NOT_INITIALIZED	应用程序之前没有调用 PeerCollabStartup。
PEER_E_SERVICE_NOT_AVAILABLE	尝试从提升的进程调用 PeerCollabSignIn 。
PEER_S_NO_CONNECTIVITY	登录成功，但 IPv6 地址目前不可用。

如果 p2phost.exe 服务未运行，此函数将启动它。

如果尝试从提升的进程启动 p2phost.exe 服务，则返回错误。因此，错误地向 p2phost.exe 授予管理权限的应用程序不会损害安全性。无法在非交互模式下启动 p2phost.exe，因为它需要显示传入邀请的 Windows 对话框。

如果用户未授权自动登录，则调用 PeerCollabSignin 将显示登录用户界面。如果指定 了 hwndParent ，则用户界面窗口将使用 hwndParent 作为父窗口。

当用户登录到“人员近我”时，用户的显示名称、计算机名称和 IP 地址将发布到子网上的对等方。用户可以选择指定用于发布的显示图片。如果未调用 PeerCollabSignin 或用户注销，则不会发布此信息。

登录后，用户可以查看在子网上登录并可供交互的对等方的列表。如果没有其他人登录到子网上的“人员近我”，则此列表将为空。

多个应用程序可以在任何给定时刻使用基础结构。不建议单个应用程序调用 PeerCollabSignout，因为其他应用程序将无法使用基础结构。应用程序还必须准备好处理用户登录和注销，或者计算机进入睡眠或休眠状态。

PeerCollabSignin 函数当前最多需要两秒钟才能完成。

显示名称不一定是唯一的。在接受交互邀请之前，用户应通过电子邮件、电话或亲自使用显示名称来验证人员的身份。

若要注销对等协作网络，请使用同一组登录选项调用 PeerCollabSignout 。用户还可以通过用户界面注销。