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

> Grava lotes de eventos baseados em entidades como eventos de Telemetry (ignorando o PlayStream). O namespace deve ser 'custom' ou começar com 'custom.'

Grava lotes de eventos baseados em entidades como eventos de Telemetry (ignorando o PlayStream). O namespace deve ser 'custom' ou começar com 'custom.'

## Sintaxe

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

### Parâmetros

**`entityHandle`**   PFEntityHandle

PFEntityHandle a ser usado para autenticação.

**`request`**   [PFEventsWriteEventsRequest\*](https://devdocs.xbox.com/pt-BR/services/playfab/api-references/c/pfeventstypes/structs/pfeventswriteeventsrequest.md)

Objeto de solicitação preenchido.

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

XAsyncBlock para a operação assíncrona.

### Valor de retorno

Tipo: HRESULT

Código de resultado desta operação de API.

## Comentários

Esta API está disponível em todas as plataformas. Esta API deve ser chamada com os cabeçalhos X-EntityToken ou X-TelemetryKey. Se X-EntityToken for enviado, o valor deverá ser um EntityToken válido para o seu título. Se X-TelemetryKey for usado, o valor deverá ser uma chave de telemetria configurada para o seu título e definida como 'Active'. Se ambos forem fornecidos, X-TelemetryKey será ignorado. Quando a tarefa assíncrona for concluída, chame [PFEventsWriteTelemetryEventsGetResultSize](https://devdocs.xbox.com/pt-BR/services/playfab/api-references/c/pfevents/functions/pfeventswritetelemetryeventsgetresultsize.md) e [PFEventsWriteTelemetryEventsGetResult](https://devdocs.xbox.com/pt-BR/services/playfab/api-references/c/pfevents/functions/pfeventswritetelemetryeventsgetresult.md) para obter o resultado.

## Requisitos

**Cabeçalho:** PFEvents.h

## Confira também

[Membros de PFEvents](https://devdocs.xbox.com/pt-BR/services/playfab/api-references/c/pfevents/pfevents_members.md)


## Related topics

- [PFEventsWriteTelemetryEventsGetResult](https://devdocs.xbox.com/pt-BR/services/playfab/api-references/c/pfevents/functions/pfeventswritetelemetryeventsgetresult.md)
- [Visão geral da API C de serviços - PFEvents.h](https://devdocs.xbox.com/pt-BR/services/playfab/api-references/c/pfevents/pfevents_members.md)
- [Write Telemetry Events](https://devdocs.xbox.com/api-reference/playstream-events/write-telemetry-events.md)
- [PFEventsWriteTelemetryEventsGetResultSize](https://devdocs.xbox.com/pt-BR/services/playfab/api-references/c/pfevents/functions/pfeventswritetelemetryeventsgetresultsize.md)
- [PFEventsWriteEventsAsync](https://devdocs.xbox.com/pt-BR/services/playfab/api-references/c/pfevents/functions/pfeventswriteeventsasync.md)