> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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\*](https://docs.xbox.com/ja-jp/services/playfab/api-references/c/pfeventstypes/structs/pfeventswriteeventsrequest.md)

値が設定されたリクエスト オブジェクト。

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

非同期操作用の XAsyncBlock。

### 戻り値

型: HRESULT

この API 操作の結果コード。

## 解説

この API はすべてのプラットフォームで利用できます。この API は X-EntityToken または X-TelemetryKey ヘッダーのいずれかを指定して呼び出す必要があります。X-EntityToken を送信する場合、値はタイトルに対して有効な EntityToken である必要があります。X-TelemetryKey を使用する場合、値はタイトルに対して 'Active' に設定された、構成済みのテレメトリ キーである必要があります。両方が指定されている場合、X-TelemetryKey は無視されます。非同期タスクが完了したら、[PFEventsWriteTelemetryEventsGetResultSize](https://docs.xbox.com/ja-jp/services/playfab/api-references/c/pfevents/functions/pfeventswritetelemetryeventsgetresultsize.md) と [PFEventsWriteTelemetryEventsGetResult](https://docs.xbox.com/ja-jp/services/playfab/api-references/c/pfevents/functions/pfeventswritetelemetryeventsgetresult.md) を呼び出して結果を取得します。

## 要件

**ヘッダー:** PFEvents.h

## 関連項目

[PFEvents のメンバー](https://docs.xbox.com/ja-jp/services/playfab/api-references/c/pfevents/pfevents_members.md)


## Related topics

- [PFEventsWriteTelemetryEventsGetResult](https://docs.xbox.com/ja-jp/services/playfab/api-references/c/pfevents/functions/pfeventswritetelemetryeventsgetresult.md)
- [Services C API overview - PFEvents.h](https://docs.xbox.com/ja-jp/services/playfab/api-references/c/pfevents/pfevents_members.md)
- [Write Telemetry Events](https://docs.xbox.com/api-reference/playstream-events/write-telemetry-events.md)
- [PFEventsWriteTelemetryEventsGetResultSize](https://docs.xbox.com/ja-jp/services/playfab/api-references/c/pfevents/functions/pfeventswritetelemetryeventsgetresultsize.md)
- [PFEventsWriteEventsAsync](https://docs.xbox.com/ja-jp/services/playfab/api-references/c/pfevents/functions/pfeventswriteeventsasync.md)