PFAuthenticationGetEntityWithSecretKeyAsync - XBOX Game Development Documentation

用于将旧版 AuthenticationTicket 或游戏 SecretKey 交换为实体令牌，或刷新仍有效的实体令牌的方法。

语法

HRESULT PFAuthenticationGetEntityWithSecretKeyAsync(  
    PFServiceConfigHandle serviceConfigHandle,  
    const char* secretKey,  
    const PFAuthenticationGetEntityRequest* request,  
    XAsyncBlock* async  
)  

参数

serviceConfigHandle PFServiceConfigHandle 从 PFServiceConfigCreateHandle 调用返回的 PFServiceConfigHandle。 secretKey char*
In_z 用于对服务请求进行身份验证的游戏密钥。 request PFAuthenticationGetEntityRequest* 已填充的请求对象。 async XAsyncBlock*
Inout 用于异步操作的 XAsyncBlock。

返回值

类型：HRESULT 此 API 操作的结果代码。

备注

此 API 可在 Win32、Linux 和 macOS 上使用。调用此 API 时必须包含 X-SecretKey、X-Authentication 或 X-EntityToken 标头。可选择性地包含 EntityKey，以尝试将生成的 EntityToken 设置为特定实体，但该实体必须与调用方存在关系，例如角色的 master_player_account。如果发送 X-EntityToken，帐户将被标记为刚登录并颁发新令牌。如果使用 X-Authentication 或 X-EntityToken，标头必须仍然有效，不能已过期或已被吊销。异步任务完成后，调用 PFAuthenticationGetEntityWithSecretKeyGetResult 获取结果。

要求

头文件： PFAuthentication.h

另请参阅

PFAuthentication 成员

​语法

​参数

​返回值

​备注

​要求

​另请参阅

语法

参数

返回值

备注

要求

另请参阅