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

# PFEventPipelineCreateTelemetryPipelineHandleWithKey

> 创建一个事件管道，使用遥测密钥上传遥测事件。

创建一个事件管道，使用遥测密钥上传遥测事件。

## 语法

```cpp theme={null}
HRESULT PFEventPipelineCreateTelemetryPipelineHandleWithKey(  
    PFEventPipelineTelemetryKeyConfig* eventPipelineTelemetryKeyConfig,  
    XTaskQueueHandle queue,  
    PFEventPipelineBatchUploadSucceededEventHandler* eventPipelineBatchUploadedEventHandler,  
    PFEventPipelineBatchUploadFailedEventHandler* eventPipelineBatchFailedEventHandler,  
    void* handlerContext,  
    PFEventPipelineHandle* eventPipelineHandle  
)  
```

### 参数

**`eventPipelineTelemetryKeyConfig`**   [PFEventPipelineTelemetryKeyConfig\*](/services/playfab/api-references/c/pfeventpipeline/structs/pfeventpipelinetelemetrykeyconfig)

如果将使用遥测密钥日志记录，则使用此配置。

**`queue`**   XTaskQueueHandle<br />*可选*

将安排后台工作并调用事件回调的异步队列。

**`eventPipelineBatchUploadedEventHandler`**   PFEventPipelineBatchUploadSucceededEventHandler\*<br />*可选*

上传一批事件时将调用的可选处理程序。

**`eventPipelineBatchFailedEventHandler`**   PFEventPipelineBatchUploadFailedEventHandler\*<br />*可选*

上传一批事件失败时将调用的可选处理程序。

**`handlerContext`**   void\*<br />*可选*

指向事件处理程序所用数据的可选指针。

**`eventPipelineHandle`**   PFEventPipelineHandle\*<br />*输出*

所创建管道的句柄。不再需要时需使用 PFEventPipelineCloseHandle 关闭。

### 返回值

类型：HRESULT

此 API 操作的结果代码。可能的值为 S\_OK、E\_INVALIDARG、E\_PF\_NOT\_INITIALIZED 或 E\_FAIL。

## 要求

**头文件：** PFEventPipeline.h

## 另请参阅

[PFEventPipeline 成员](/services/playfab/api-references/c/pfeventpipeline/pfeventpipeline_members)