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

# PFCloudScriptClientExecuteCloudScriptAsync

> 客户端 API，用于在服务器端执行 PlayFab CloudScript 函数，并将 currentPlayerId 设置为已通过身份验证的玩家的 PlayFab（主账号）ID。

执行 CloudScript 函数，并将 'currentPlayerId' 设置为已通过身份验证的玩家的 PlayFab ID。PlayFab ID 是该玩家 master\_player\_account 实体的实体 ID。

## 语法

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

### 参数

**`entityHandle`**   PFEntityHandle

用于身份验证的 PFEntityHandle。

**`request`**   [PFCloudScriptExecuteCloudScriptRequest\*](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfcloudscripttypes/structs/pfcloudscriptexecutecloudscriptrequest.md)

已填充的请求对象。

**`async`**   XAsyncBlock\*\
*Inout*

用于异步操作的 XAsyncBlock。

### 返回值

类型：HRESULT

此 API 操作的结果代码。

## 备注

此 API 在所有平台上均可用。异步任务完成后，请调用 [PFCloudScriptClientExecuteCloudScriptGetResultSize](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfcloudscript/functions/pfcloudscriptclientexecutecloudscriptgetresultsize.md) 和 [PFCloudScriptClientExecuteCloudScriptGetResult](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfcloudscript/functions/pfcloudscriptclientexecutecloudscriptgetresult.md) 以获取结果。

## 要求

**头文件：** PFCloudScript.h

## 另请参阅

[PFCloudScript 成员](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfcloudscript/pfcloudscript_members.md)


## Related topics

- [PFCloudScriptClientExecuteCloudScriptGetResult](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfcloudscript/functions/pfcloudscriptclientexecutecloudscriptgetresult.md)
- [Services C API overview - PFCloudScript.h](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfcloudscript/pfcloudscript_members.md)
- [Execute Cloud Script](https://docs.xbox.com/api-reference/server-side-cloud-script/execute-cloud-script.md)
- [PFCloudScriptClientExecuteCloudScriptGetResultSize](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfcloudscript/functions/pfcloudscriptclientexecutecloudscriptgetresultsize.md)
- [PFCloudScriptExecuteEntityCloudScriptAsync](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfcloudscript/functions/pfcloudscriptexecuteentitycloudscriptasync.md)