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

> 지정된 엔터티의 컨텍스트에서 서버 측에서 PlayFab CloudScript(JavaScript) 함수를 실행하고, 사용자 지정 서버 로직 결과를 호출자에게 반환합니다.

Cloud Script는 PlayFab에서 가장 다재다능한 기능 중 하나입니다. 이를 통해 클라이언트 코드가 구현할 수 있는 모든 종류의 사용자 지정 서버 측 기능 실행을 요청할 수 있으며, 사실상 모든 것과 함께 사용할 수 있습니다.

## Syntax

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

### Parameters

**`entityHandle`**   PFEntityHandle

인증에 사용할 PFEntityHandle입니다.

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

채워진 요청 개체입니다.

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

비동기 작업을 위한 XAsyncBlock입니다.

### Return value

Type: HRESULT

이 API 작업의 결과 코드입니다.

## Remarks

이 API는 모든 플랫폼에서 사용할 수 있습니다. 요청에서 정의된 엔터티 프로필로 CloudScript를 실행합니다. 비동기 작업이 완료되면 [PFCloudScriptExecuteEntityCloudScriptGetResultSize](/services/playfab/api-references/c/pfcloudscript/functions/pfcloudscriptexecuteentitycloudscriptgetresultsize) 및 [PFCloudScriptExecuteEntityCloudScriptGetResult](/services/playfab/api-references/c/pfcloudscript/functions/pfcloudscriptexecuteentitycloudscriptgetresult)를 호출하여 결과를 가져옵니다.

## Requirements

**Header:** PFCloudScript.h

## See also

[PFCloudScript 멤버](/services/playfab/api-references/c/pfcloudscript/pfcloudscript_members)
