Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
This method refreshes the presence subscription for this buddy.
HRESULT Refresh();
Parameters
None.
Return Values
This method can return an RTC_E_ constant. The following table shows additional possible return values.
| Value | Meaning |
|---|---|
| E_FAIL | The session is in the disconnected state. |
| E_OUTOFMEMORY | Insufficient memory to perform this operation. |
Remarks
This method is called to update the presence subscription of the buddy. When the buddy is of type RTCBT_POLL, this method must be called to obtain the current presence status of the buddy. The application receives an RTCBET_BUDDY_STATE_CHANGE notification whenever this method is called. The presence status can be obtained by calling the IRTCBuddyEvent2::StatusText method to retrieve the presence status.
The RTC API caches the presence state of a polled buddy for two minutes. As a result, if the application calls Refresh twice within two minutes, the same presence state is returned to the application.
Requirements
OS Versions: Windows CE .NET 4.2 and later.
Header: Rtccore.h, Rtccore.idl.
Link Library: Uuid.lib.
See Also
IRTCBuddy2 | IRTCBuddyEvent2::StatusText | RTCBET_BUDDY_STATE_CHANGE | RTCBT_POLL
Send Feedback on this topic to the authors