IRTCClientPresence::SetLocalPresenceInfo
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
Note
This method is unsupported in Windows Embedded CE 6.0.
This method sets the local presence status.
All active watchers are instantly notified of the change.
This method sets information that can be retrieved from the IRTCBuddy::Notes and IRTCBuddy::Status methods.
Syntax
HRESULT SetLocalPresenceInfo(
RTC_PRESENCE_STATUS enStatus,
BSTR bstrNotes
);
Parameters
- enStatus
[in] An RTC_PRESENCE_STATUS enumeration value specifying the presence status.
- bstrNotes
[in] Custom user-provided text that might have meaning for the active watchers.
Return Value
This method can return an RTC_E_ constant.
The following table shows an additional possible return value.
| Value | Meaning |
|---|---|
E_INVALID_ARG |
The bstrNotes parameter is too large. This parameter is limited to 511 characters. |
Requirements
| Header | rtccore.h, rtccore.idl |
| Library | uuid.lib |
| Windows Embedded CE | Windows CE .NET 4.0 and later |
See Also
Reference
IRTCClientPresence
IRTCBuddy::Notes
IRTCBuddy::Status
RTC_PRESENCE_STATUS