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

# PFCloudScriptExecuteEntityCloudScriptRequest

> PFCloudScriptExecuteEntityCloudScriptRequest 데이터 모델입니다. 요청에 정의된 엔터티 프로필을 사용하여 CloudScript를 실행합니다.

PFCloudScriptExecuteEntityCloudScriptRequest 데이터 모델입니다. 요청에 정의된 엔터티 프로필을 사용하여 CloudScript를 실행합니다.

## 구문

```cpp theme={null}
typedef struct PFCloudScriptExecuteEntityCloudScriptRequest {  
    PFStringDictionaryEntry const* customTags;  
    uint32_t customTagsCount;  
    PFEntityKey const* entity;  
    const char* functionName;  
    PFJsonObject functionParameter;  
    bool const* generatePlayStreamEvent;  
    PFCloudScriptCloudScriptRevisionOption const* revisionSelection;  
    int32_t const* specificRevision;  
} PFCloudScriptExecuteEntityCloudScriptRequest;  
```

### 멤버

**`customTags`**   [PFStringDictionaryEntry](/services/playfab/api-references/c/pftypes/structs/pfstringdictionaryentry) const\*<br />*may be nullptr*

(선택 사항) 요청과 연결된 선택적 사용자 지정 태그입니다(예: 빌드 번호, 외부 추적 식별자 등).

**`customTagsCount`**   uint32\_t

customTags의 개수

**`entity`**   [PFEntityKey](/services/playfab/api-references/c/pftypes/structs/pfentitykey-c) const\*<br />*may be nullptr*

(선택 사항) 이 작업을 수행할 선택적 엔터티입니다. 기본값은 현재 로그인한 엔터티입니다.

**`functionName`**   const char\*<br />*is null-terminated*

실행할 CloudScript 함수의 이름입니다.

**`functionParameter`**   [PFJsonObject](/services/playfab/api-references/c/pftypes/structs/pfjsonobject)

(선택 사항) 함수에 첫 번째 인수로 전달되는 개체입니다.

**`generatePlayStreamEvent`**   bool const\*<br />*may be nullptr*

(선택 사항) 함수 실행 결과 및 기타 컨텍스트 정보를 포함하는 'entity\_executed\_cloudscript' PlayStream 이벤트를 생성합니다. 이 이벤트는 Game Manager의 해당 플레이어에 대한 PlayStream 디버거 콘솔에 표시됩니다.

**`revisionSelection`**   [PFCloudScriptCloudScriptRevisionOption](/services/playfab/api-references/c/pfcloudscripttypes/enums/pfcloudscriptcloudscriptrevisionoption) const\*<br />*may be nullptr*

(선택 사항) 실행할 CloudScript의 개정 옵션입니다. 'Latest'는 가장 최근에 만들어진 개정을 실행하고, 'Live'는 현재 라이브 상태로 게시된 개정을 실행하며, 'Specific'은 지정된 개정을 실행합니다. SpecificRevision 매개 변수가 지정된 경우 기본값은 'Specific'이며, 그렇지 않은 경우에는 'Live'입니다.

**`specificRevision`**   int32\_t const\*<br />*may be nullptr*

(선택 사항) RevisionSelection이 'Specific'으로 설정된 경우 실행할 특정 개정입니다.

## 요구 사항

**헤더:** PFCloudScriptTypes.h

## 참고 항목

[PFCloudScriptTypes 멤버](/services/playfab/api-references/c/pfcloudscripttypes/pfcloudscripttypes_members)


## Related topics

- [PFCloudScriptExecuteEntityCloudScriptAsync](/ko/services/playfab/api-references/c/pfcloudscript/functions/pfcloudscriptexecuteentitycloudscriptasync.md)
- [Services C API 개요 - PFCloudScriptTypes.h](/ko/services/playfab/api-references/c/pfcloudscripttypes/pfcloudscripttypes_members.md)
- [PFCloudScriptClientExecuteCloudScriptAsync](/ko/services/playfab/api-references/c/pfcloudscript/functions/pfcloudscriptclientexecutecloudscriptasync.md)
- [PFCloudScriptServerExecuteCloudScriptAsync](/ko/services/playfab/api-references/c/pfcloudscript/functions/pfcloudscriptserverexecutecloudscriptasync.md)
- [PFCloudScriptExecuteEntityCloudScriptGetResult](/ko/services/playfab/api-references/c/pfcloudscript/functions/pfcloudscriptexecuteentitycloudscriptgetresult.md)