PeerCollabSetPresenceInfo 函数 (p2p.h)
PeerCollabSetPresenceInfo 函数将调用方的状态信息更新给监视它的任何联系人。
语法
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabSetPresenceInfo(
[in] PCPEER_PRESENCE_INFO pcPresenceInfo
);
参数
[in] pcPresenceInfo
指向 PEER_PRESENCE_INFO 结构的指针,该结构包含要为调用对等应用程序发布的新状态信息。
返回值
如果函数成功,则返回S_OK。 否则,该函数返回以下值之一。
返回代码 | 说明 |
---|---|
|
内存不足,无法支持此操作。 |
|
其中一个参数无效。 |
|
Windows 对等基础结构未初始化。 需要调用相关的初始化函数。 |
|
该操作要求用户登录。 |
注解
监视此对等方状态的联系人将在本地引发PEER_EVENT_PRESENCE_CHANGED事件,该事件指示此对等方的状态更改。 登录时,无法将对等方的状态设置为脱机。 默认情况下,对等方的状态为“联机”,登录时的描述性文本为 NULL 。
状态的任何描述性文本限制为 255 个 Unicode 字符。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | 无受支持的版本 |
目标平台 | Windows |
标头 | p2p.h |
Library | P2P.lib |
DLL | P2P.dll |