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