> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PFAuthenticationGetEntityWithSecretKeyAsync

> 将游戏 SecretKey 交换为实体令牌，或刷新供 PlayFab 服务器端集成用于 API 调用的仍有效的实体令牌。

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

## 语法

```cpp theme={null}
HRESULT PFAuthenticationGetEntityWithSecretKeyAsync(  
    PFServiceConfigHandle serviceConfigHandle,  
    const char* secretKey,  
    const PFAuthenticationGetEntityRequest* request,  
    XAsyncBlock* async  
)  
```

### 参数

**`serviceConfigHandle`**   PFServiceConfigHandle

从 PFServiceConfigCreateHandle 调用返回的 PFServiceConfigHandle。

**`secretKey`**   char\*<br />*In\_z*

用于对服务请求进行身份验证的游戏密钥。

**`request`**   [PFAuthenticationGetEntityRequest\*](/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationgetentityrequest)

已填充的请求对象。

**`async`**   XAsyncBlock\*<br />*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](/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationgetentitywithsecretkeygetresult) 获取结果。

## 要求

**头文件：** PFAuthentication.h

## 另请参阅

[PFAuthentication 成员](/services/playfab/api-references/c/pfauthentication/pfauthentication_members)


## Related topics

- [PFAuthenticationGetEntityWithSecretKeyGetResult](/zh-CN/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationgetentitywithsecretkeygetresult.md)
- [PFSegmentsServerGetAllSegmentsAsync](/zh-CN/services/playfab/api-references/c/pfsegments/functions/pfsegmentsservergetallsegmentsasync.md)
- [PFTitleDataManagementServerGetTimeAsync](/zh-CN/services/playfab/api-references/c/pftitledatamanagement/functions/pftitledatamanagementservergettimeasync.md)
- [PFSegmentsServerGetPlayerSegmentsAsync](/zh-CN/services/playfab/api-references/c/pfsegments/functions/pfsegmentsservergetplayersegmentsasync.md)
- [PFSegmentsServerGetPlayersInSegmentAsync](/zh-CN/services/playfab/api-references/c/pfsegments/functions/pfsegmentsservergetplayersinsegmentasync.md)