PartyNetwork::RevokeInvitation

排队异步尝试,从网络撤消邀请。

语法

PartyError RevokeInvitation(  
    const PartyLocalUser* localUser,  
    PartyInvitation* invitation,  
    void* asyncIdentifier  
)  

参数

localUserPartyLocalUser*

尝试撤销邀请的本地用户。

invitationPartyInvitation*

要撤销的邀请。

asyncIdentifier void*

一个可选应用定义的指针大小的上下文值,可用于将完成状态更改与此调用关联起来。

返回值

PartyError

如果取消邀请的异步操作开始,则为 c_partyErrorSuccess; 否则为错误代码。 如果此方法失败,则不会生成任何相关的状态更改。 可通过 PartyManager::GetErrorMessage() 检索错误代码的可读形式。

备注

游戏可能会撤销邀请,以防止更多用户使用邀请的标识符在网络中进行身份验证。

此方法将异步尝试排队以撤销来自网络的邀请。 异步操作完成后,将提供 PartyRevokeInvitationCompletedStateChange ,指示成功或失败。 成功时,会预先使用 PartyDestroyedReason::Requested 生成 PartyInvitationDestroyedStateChange,以指示网络将不再接受使用邀请标识符的身份验证,直到使用相同标识符创建新邀请为止。 它还指示邀请将不再可通过 GetInvitations()查询。

只有在创建邀请时指定了可撤销性,以便本地设备上的 localUser 可以撤销邀请时,此操作才会成功。 如果可撤销性设置为 PartyInvitationRevocability::Creator ,并且 localUser 在创建者以外的设备上进行身份验证,或者 localUser 引用的用户与创建者不同,则可能并非如此。

要求

标题: Party.h

另请参阅

PartyNetwork
PartyRevokeInvitationCompletedStateChange
PartyInvitationDestroyedStateChange