> ## 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\*](/zh-TW/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 金鑰。如果兩者都有提供，X-TelemetryKey 將被忽略。非同步工作完成時，請呼叫 [PFEventsWriteTelemetryEventsGetResultSize](/zh-TW/services/playfab/api-references/c/pfevents/functions/pfeventswritetelemetryeventsgetresultsize) 和 [PFEventsWriteTelemetryEventsGetResult](/zh-TW/services/playfab/api-references/c/pfevents/functions/pfeventswritetelemetryeventsgetresult) 以取得結果。

## 需求

**標頭：** PFEvents.h

## 另請參閱

[PFEvents 成員](/zh-TW/services/playfab/api-references/c/pfevents/pfevents_members)


## Related topics

- [PFEventsWriteTelemetryEventsGetResult](/zh-TW/services/playfab/api-references/c/pfevents/functions/pfeventswritetelemetryeventsgetresult.md)
- [服務 C API 概觀 - PFEvents.h](/zh-TW/services/playfab/api-references/c/pfevents/pfevents_members.md)
- [Write Telemetry Events](/api-reference/playstream-events/write-telemetry-events.md)
- [PFEventsWriteTelemetryEventsGetResultSize](/zh-TW/services/playfab/api-references/c/pfevents/functions/pfeventswritetelemetryeventsgetresultsize.md)
- [PFEventsWriteEventsAsync](/zh-TW/services/playfab/api-references/c/pfevents/functions/pfeventswriteeventsasync.md)