DWC_SetFriendStatusCallback

Syntax

#include <dwc.h>

BOOL DWC_SetFriendStatusCallback(DWCFriendStatusCallback callback,
                                 void *param);

Arguments

callback Pointer to the callback function that notifies the user about changes to friend status.
param Callback parameter.

Return Values

TRUE The configuration of the callback function was successful.
FALSE The configuration failed because the FriendsMatch Library was not running.

Description

This function configures the callback function that is called when a friend's communication status changes. Refer to the description of the DWC_GetFriendStatus function for more details about the communication status.

This callback function is usually set as an argument of the DWC_UpdateServersAsync function used in the friend roster synchronization process. Even when no friend roster synchronization process is needed, if there is a need to know the friend's communication status in real time, use this function to configure the callback function.

The callback function set here is called each time a friend's communication status changes.

Revision History


CONFIDENTIAL