IRTCBuddy2::Refresh (Windows CE 5.0)
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