peerCollabSetPresenceInfo 函式 (p2p.h)

PeerCollabSetPresenceInfo 函式會將呼叫端的目前狀態資訊更新為監看它的任何聯繫人。

語法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabSetPresenceInfo(
  [in] PCPEER_PRESENCE_INFO pcPresenceInfo
);

[in] pcPresenceInfo

PEER_PRESENCE_INFO結構的指標，其中包含要針對呼叫對等應用程序發行的新目前狀態資訊。

如果函式成功，則傳回S_OK。否則，函式會傳回下列其中一個值。

傳回碼	Description
E_OUTOFMEMORY	記憶體不足，無法支援這項作業。
E_INVALIDARG	其中一個自變數無效。
PEER_E_NOT_INITIALIZED	Windows 對等基礎結構未初始化。需要呼叫相關的初始化函式。
PEER_E_NOT_SIGNED_IN	此作業需要使用者登入。

監看此對等目前狀態的聯繫人會在本機引發PEER_EVENT_PRESENCE_CHANGED事件，以發出此對等目前狀態變更的訊號。登入時，對等的目前狀態無法設定為離線。根據預設，對等的目前狀態為「在線」，而描述性文字在登入時為 NULL 。

目前狀態的任何描述性文字限制為 255 個 Unicode 字元。