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

# PFEventsWriteTelemetryEventsAsync

> 엔터티 기반 이벤트 일괄 처리를 원격 분석(Telemetry) 이벤트로 씁니다(PlayStream 우회). 네임스페이스는 'custom'이거나 'custom.'으로 시작해야 합니다.

엔터티 기반 이벤트 일괄 처리를 원격 분석(Telemetry) 이벤트로 씁니다(PlayStream 우회). 네임스페이스는 'custom'이거나 'custom.'으로 시작해야 합니다.

## 구문

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

### 매개 변수

**`entityHandle`**   PFEntityHandle

인증에 사용할 PFEntityHandle입니다.

**`request`**   [PFEventsWriteEventsRequest\*](/services/playfab/api-references/c/pfeventstypes/structs/pfeventswriteeventsrequest)

채워진 요청 개체입니다.

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

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

### 반환 값

형식: HRESULT

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

## 설명

이 API는 모든 플랫폼에서 사용할 수 있습니다. 이 API는 X-EntityToken 또는 X-TelemetryKey 헤더 중 하나로 호출해야 합니다. X-EntityToken을 보내는 경우 값은 타이틀에 유효한 EntityToken이어야 합니다. X-TelemetryKey를 사용하는 경우 값은 타이틀에 대해 'Active'로 설정된 Telemetry Key여야 합니다. 두 헤더가 모두 제공되면 X-TelemetryKey는 무시됩니다. 비동기 작업이 완료되면 [PFEventsWriteTelemetryEventsGetResultSize](/services/playfab/api-references/c/pfevents/functions/pfeventswritetelemetryeventsgetresultsize)와 [PFEventsWriteTelemetryEventsGetResult](/services/playfab/api-references/c/pfevents/functions/pfeventswritetelemetryeventsgetresult)를 호출하여 결과를 가져옵니다.

## 요구 사항

**헤더:** PFEvents.h

## 참고 항목

[PFEvents 멤버](/services/playfab/api-references/c/pfevents/pfevents_members)


## Related topics

- [PFEventsWriteTelemetryEventsGetResult](/ko/services/playfab/api-references/c/pfevents/functions/pfeventswritetelemetryeventsgetresult.md)
- [Services C API 개요 - PFEvents.h](/ko/services/playfab/api-references/c/pfevents/pfevents_members.md)
- [PFEventsWriteTelemetryEventsGetResultSize](/ko/services/playfab/api-references/c/pfevents/functions/pfeventswritetelemetryeventsgetresultsize.md)
- [PFEventsWriteEventsAsync](/ko/services/playfab/api-references/c/pfevents/functions/pfeventswriteeventsasync.md)
- [Telemetry](/ko/services/playfab/data-analytics/ingest-data/telemetry-overview.md)