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

# PFCloudScriptExecuteEntityCloudScriptAsync

> Executa uma função CloudScript (JavaScript) do PlayFab no lado do servidor no contexto de uma entidade especificada, retornando ao chamador os resultados da lógica personalizada do servidor.

O Cloud Script é um dos recursos mais versáteis do PlayFab. Ele permite que o código do cliente solicite a execução de qualquer tipo de funcionalidade personalizada no lado do servidor que você possa implementar, e pode ser usado em conjunto com praticamente qualquer coisa.

## Sintaxe

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

### Parâmetros

**`entityHandle`**   PFEntityHandle

PFEntityHandle a ser usado para autenticação.

**`request`**   [PFCloudScriptExecuteEntityCloudScriptRequest\*](/pt-BR/services/playfab/api-references/c/pfcloudscripttypes/structs/pfcloudscriptexecuteentitycloudscriptrequest)

Objeto de solicitação preenchido.

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

XAsyncBlock para a operação assíncrona.

### Valor de retorno

Tipo: HRESULT

Código de resultado desta operação de API.

## Comentários

Esta API está disponível em todas as plataformas. Executa o CloudScript com o perfil da entidade definido na solicitação. Quando a tarefa assíncrona for concluída, chame [PFCloudScriptExecuteEntityCloudScriptGetResultSize](/pt-BR/services/playfab/api-references/c/pfcloudscript/functions/pfcloudscriptexecuteentitycloudscriptgetresultsize) e [PFCloudScriptExecuteEntityCloudScriptGetResult](/pt-BR/services/playfab/api-references/c/pfcloudscript/functions/pfcloudscriptexecuteentitycloudscriptgetresult) para obter o resultado.

## Requisitos

**Cabeçalho:** PFCloudScript.h

## Confira também

[Membros de PFCloudScript](/pt-BR/services/playfab/api-references/c/pfcloudscript/pfcloudscript_members)


## Related topics

- [PFCloudScriptExecuteEntityCloudScriptGetResult](/pt-BR/services/playfab/api-references/c/pfcloudscript/functions/pfcloudscriptexecuteentitycloudscriptgetresult.md)
- [Visão geral da API C do Services - PFCloudScript.h](/pt-BR/services/playfab/api-references/c/pfcloudscript/pfcloudscript_members.md)
- [PFCloudScriptServerExecuteCloudScriptAsync](/pt-BR/services/playfab/api-references/c/pfcloudscript/functions/pfcloudscriptserverexecutecloudscriptasync.md)
- [PFCloudScriptClientExecuteCloudScriptAsync](/pt-BR/services/playfab/api-references/c/pfcloudscript/functions/pfcloudscriptclientexecutecloudscriptasync.md)
- [Execute Cloud Script](/api-reference/server-side-cloud-script/execute-cloud-script.md)