PeerCollabSetPresenceInfo 函数 (p2p.h)

PeerCollabSetPresenceInfo 函数将调用方的状态信息更新给监视它的任何联系人。

语法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabSetPresenceInfo(
  [in] PCPEER_PRESENCE_INFO pcPresenceInfo
);

[in] pcPresenceInfo

指向 PEER_PRESENCE_INFO 结构的指针，该结构包含要为调用对等应用程序发布的新状态信息。

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

返回代码	说明
E_OUTOFMEMORY	内存不足，无法支持此操作。
E_INVALIDARG	其中一个参数无效。
PEER_E_NOT_INITIALIZED	Windows 对等基础结构未初始化。需要调用相关的初始化函数。
PEER_E_NOT_SIGNED_IN	该操作要求用户登录。

监视此对等方状态的联系人将在本地引发PEER_EVENT_PRESENCE_CHANGED事件，该事件指示此对等方的状态更改。登录时，无法将对等方的状态设置为脱机。默认情况下，对等方的状态为“联机”，登录时的描述性文本为 NULL 。

状态的任何描述性文本限制为 255 个 Unicode 字符。