構文
パラメーター
lobby PFLobbyHandle
ロビーのハンドル。
localUser PFEntityKey*
更新を送信するローカル ユーザー。
lobbyUpdate PFLobbyDataUpdate*省略可能
localUser に代わってロビーの共有部分に適用する任意の更新。指定しない場合は、memberUpdate を指定する必要があります。
memberUpdate PFLobbyMemberDataUpdate*省略可能
localUser が所有するロビー部分に適用する任意の更新。このパラメーターを指定しない場合は、lobbyUpdate を指定する必要があります。
asyncContext void*省略可能 完了状態の変化をこの呼び出しに関連付けるために使用できる、アプリ定義のポインター サイズのコンテキスト値 (省略可能)。
戻り値
型: HRESULT 呼び出しが成功した場合はS_OK、それ以外の場合はエラー コード。エラー コードの人間が判読可能な形式は、PFMultiplayerGetErrorMessage() を通じて取得できます。
解説
これは非同期操作です。正常に完了すると、タイトルには PFLobbyPostUpdateCompletedStateChange::result フィールドがS_OK に設定された PFLobbyPostUpdateCompletedStateChange が提供されます。失敗して完了した場合、タイトルには PFLobbyPostUpdateCompletedStateChange::result フィールドが失敗に設定された PFLobbyPostUpdateCompletedStateChange が提供されます。更新の適用によってロビーの状態が変化する場合は、しばらくしてから PFLobbyUpdatedStateChange がタイトルに提供されます。この操作が正常に完了することは、ロビー サービスが更新を受け入れたことのみを示します。ロビー状態のタイトルのローカル ビューは、更新された状態を伴う PFLobbyUpdatedStateChange がタイトルに提供されるまで、この更新を反映しません。
lobbyUpdate には、ロビーの所有者のみが変更できるフィールドが含まれています。このメソッドは、こうしたフィールドの 1 つが指定され、かつ localUser がロビーの所有者ではない場合にエラーを返します。単一のエンティティに代わって
lobbyUpdate と memberUpdate の両方がこのメソッドに指定された場合、両方の更新はアトミックに行われます。
要件
ヘッダー: PFLobby.h関連項目
PFLobby メンバーPFLobbyServerPostUpdate