DWC_SetFriendStatusCallback

構文

#include <dwc.h>
BOOL DWC_SetFriendStatusCallback(DWCFriendStatusCallback callback,
                                 void *param);

引数

callback 友達状態変化通知コールバック関数へのポインタ
param コールバック用パラメータ

返り値

TRUE コールバック関数設定成功
FALSE FriendsMatchライブラリ非動作中で設定失敗

説明

友達の通信状態が変化した時に呼び出されるコールバック関数を設定します。通信状態についてはDWC_GetFriendStatus関数の説明を参照してください。

このコールバック関数は、通常は友達リスト同期処理のDWC_UpdateServersAsync関数の引数としてセットしますが、友達リスト同期処理が必要ない場合でも友達の通信状態をリアルタイムで把握したい場合に、本関数を用いてコールバック関数を設定してください。

ここでセットしたコールバック関数は、友達の通信状態が変化する度に呼び出されます。

DWC_UpdateServersAsync関数を呼ぶと、この関数で設定したコールバック関数を上書きしますので注意して下さい。

履歴

5.1pr2
DWC_UpdateServersAsync関数によって、コールバック関数が上書きされる旨を追記

5.1pr2より前の変更履歴はこちら