PartyNetwork::RevokeInvitation
排队异步尝试,从网络撤消邀请。
语法
PartyError RevokeInvitation(
const PartyLocalUser* localUser,
PartyInvitation* invitation,
void* asyncIdentifier
)
参数
localUser
PartyLocalUser*
尝试撤销邀请的本地用户。
invitation
PartyInvitation*
要撤销的邀请。
asyncIdentifier
void*
一个可选应用定义的指针大小的上下文值,可用于将完成状态更改与此调用关联起来。
返回值
PartyError
如果取消邀请的异步操作开始,则为 c_partyErrorSuccess
; 否则为错误代码。 如果此方法失败,则不会生成任何相关的状态更改。 可通过 PartyManager::GetErrorMessage() 检索错误代码的可读形式。
备注
游戏可能会撤销邀请,以防止更多用户使用邀请的标识符在网络中进行身份验证。
此方法将异步尝试排队以撤销来自网络的邀请。 异步操作完成后,将提供 PartyRevokeInvitationCompletedStateChange ,指示成功或失败。 成功时,会预先使用 PartyDestroyedReason::Requested 生成 PartyInvitationDestroyedStateChange,以指示网络将不再接受使用邀请标识符的身份验证,直到使用相同标识符创建新邀请为止。 它还指示邀请将不再可通过 GetInvitations()查询。
只有在创建邀请时指定了可撤销性,以便本地设备上的 localUser
可以撤销邀请时,此操作才会成功。 如果可撤销性设置为 PartyInvitationRevocability::Creator ,并且 localUser
在创建者以外的设备上进行身份验证,或者 localUser
引用的用户与创建者不同,则可能并非如此。
要求
标题: Party.h
另请参阅
PartyNetwork
PartyRevokeInvitationCompletedStateChange
PartyInvitationDestroyedStateChange