DWC_SetOwnStatusData

構文

#include <dwc.h>
BOOL DWC_SetOwnStatusData(const char *statusData,
                          u32 size);

引数

statusData statusデータにセットするバイナリデータへのポインタ。
size バイナリデータのサイズ。最大容量は189Byteまで。

返り値

TRUE セット成功
FALSE ログイン前、容量オーバーなどでセット失敗

説明

自分の通信状態のうち、statusデータをセットします。

プレイヤーの通信状態は、プレイヤーのオンライン、オフライン等の状態を表すstatusフラグと、アプリケーションが設定できるstatus文字列から成っており、GameSpyサーバ上で管理されています。本関数では、statusDataで指定されたバイナリデータ(statusデータと呼びます)をBase64でエンコードし、status文字列としてGameSpyサーバに送信しています。statusフラグの種別についてはDWC_GetFriendStatus関数の返り値の欄を参照してください。

この関数を使うためには、DWC_LoginAsync関数によるログインまでを完了させておく必要があります。

セットされたデータは、他のホストからDWC_GetFriendStatusData*関数で取得することができます。

バイナリデータではなく文字列をセットしたい場合は、DWC_SetOwnStatusString関数を使用してください。

セットされた文字列は、DWC_ShutdownFriendsMatch関数を呼び出した時にクリアされます。

履歴

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