DWC_LoadOthersDataAsync

構文

#include <dwc.h>
BOOL DWC_LoadOthersDataAsync(char *keys,
                             int index,
                             void *param);

引数

keys ロードしたいデータのキー文字列へのポインタ
index ロードしたいユーザの友達リストのインデックス
param コールバック用パラメータ

返り値

TRUE ロード開始
FALSE 自分がオフライン状態か相手が友達でない、もしくはエラー発生中でロードできない

説明

データストレージサーバから、他人がDWC_SavePublicDataAsync関数でセーブしたデータをロードします。友達関係が成立していない場合(友達情報のデータタイプが友達登録鍵のもの)でもデータをロードすることが可能なことに注意してください。

ロードするデータはkeysで指定し、ヌル文字終端の文字列である必要があります。
keysは"\name\stage"のように'\'で区切って記述します。この例のように複数のキーを一度にロードすることができます。データのロードが完了したら、DWC_SetStorageServerCallbackで指定したロード完了通知コールバックが呼ばれます。

存在しないキーや、友達がDWC_SavePrivateDataAsync関数でセーブしたキーのみをロードしようとした場合は、コールバックの引数successはFALSEになります。ただし、複数のキーを指定したうちの、一部だけが上記のようなキーであった場合は、ロードデータにそのキーが含まれないだけで、引数successはTRUEになります。

ロード中にルーターの上流回線が切断されたときなどは、コールバックが呼び出されない可能性があります。従って、アプリケーション側でタイムアウトを設けたり、ユーザーがキャンセルできるインターフェースにしてください。

キャンセルするためには、DWC_LogoutFromStorageServer関数を呼び出してください。

データのセーブとロードが同時に発生しても、セーブ途中のデータがロードされることはありません。セーブ前か後のデータがロードされることになります。

履歴

5.1pr2
DWC_LoadOwnDataAsync関数の廃止に伴い、DWC_LoadOwnDataAsyncをDWC_LoadOwnPrivateDataAsyncに置換

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