> ## 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.

# PFAccountManagementClientLinkFacebookAccountAsync

> 将与所提供 Facebook 访问令牌关联的 Facebook 账户与用户的 PlayFab 账户关联

将与所提供 Facebook 访问令牌关联的 Facebook 账户与用户的 PlayFab 账户关联

## 语法

```cpp theme={null}
HRESULT PFAccountManagementClientLinkFacebookAccountAsync(  
    PFEntityHandle entityHandle,  
    const PFAccountManagementLinkFacebookAccountRequest* request,  
    XAsyncBlock* async  
)  
```

### 参数

**`entityHandle`**   PFEntityHandle

用于身份验证的 PFEntityHandle。

**`request`**   [PFAccountManagementLinkFacebookAccountRequest\*](/services/playfab/api-references/c/pfaccountmanagementtypes/structs/pfaccountmanagementlinkfacebookaccountrequest)

已填充的请求对象。

**`async`**   XAsyncBlock\*<br />*Inout*

用于异步操作的 XAsyncBlock。

### 返回值

类型：HRESULT

此 API 操作的结果代码。

## 备注

此 API 适用于 Win32、Linux、Android、iOS 和 macOS。 Facebook 登录通过 Facebook 用户访问令牌实现。有关该令牌的更多信息，请参阅 Facebook 开发者文档 ([https://developers.facebook.com/docs/facebook-login/access-tokens/](https://developers.facebook.com/docs/facebook-login/access-tokens/))。例如，在 Unity 中，该令牌可作为 Facebook SDK ScriptableObject FB 中的 AccessToken 使用。请注意，游戏切勿在多个 PlayFab 游戏 ID 之间重复使用相同的 Facebook 应用程序，因为 Facebook 为每个应用程序提供唯一的用户 ID，这样做可能会导致用户 PlayFab 账户信息中的 Facebook ID 出现问题。如果必须在新的 PlayFab 游戏 ID 中重复使用某个应用程序，请务必先取消所有账户与 Facebook 的关联，或删除第一个游戏 ID 中的所有用户。 另请参阅 ClientLoginWithFacebookAsync, ClientUnlinkFacebookAccountAsync。调用 XAsyncGetStatus 以获取操作的状态。 如果服务调用不成功，异步结果将是 E\_PF\_ACCOUNT\_ALREADY\_LINKED, E\_PF\_ACCOUNT\_NOT\_FOUND, E\_PF\_FACEBOOK\_API\_ERROR, E\_PF\_INVALID\_FACEBOOK\_TOKEN, E\_PF\_LINKED\_ACCOUNT\_ALREADY\_CLAIMED 或全局 PlayFab 服务错误之一。 有关错误处理的详细信息，请参阅文档页面 "Handling PlayFab Errors"。

## 要求

**头文件：** PFAccountManagement.h

## 另请参阅

[PFAccountManagement 成员](/services/playfab/api-references/c/pfaccountmanagement/pfaccountmanagement_members)


## Related topics

- [服务 C API 概览 - PFAccountManagement.h](/zh-CN/services/playfab/api-references/c/pfaccountmanagement/pfaccountmanagement_members.md)
- [PFAccountManagementClientLinkFacebookInstantGamesIdAsync](/zh-CN/services/playfab/api-references/c/pfaccountmanagement/functions/pfaccountmanagementclientlinkfacebookinstantgamesidasync.md)
- [PFAccountManagementClientUnlinkFacebookAccountAsync](/zh-CN/services/playfab/api-references/c/pfaccountmanagement/functions/pfaccountmanagementclientunlinkfacebookaccountasync.md)
- [PFAccountManagementClientUnlinkFacebookInstantGamesIdAsync](/zh-CN/services/playfab/api-references/c/pfaccountmanagement/functions/pfaccountmanagementclientunlinkfacebookinstantgamesidasync.md)
- [PFAccountManagementLinkFacebookAccountRequest](/zh-CN/services/playfab/api-references/c/pfaccountmanagementtypes/structs/pfaccountmanagementlinkfacebookaccountrequest.md)