#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より前の変更履歴はこちら