---
title: HccnRpingAddTarget
description: "| 产品 | 是否支持 |"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/others/rpingdev/hccnrpingapi_07_0004.html
sourcePath: /source/zh/canncommercial/900/others/rpingdev/hccnrpingapi_07_0004.html
indexId: c53dbe657827bf1ef00558cc61380e7bbf35b621b50e3cf63516cabfc16ec98571
---
# HccnRpingAddTarget

#### 产品支持情况

| 产品 | 是否支持 |
| --- | --- |
| Atlas 350 加速卡 | √ |
| Atlas A3 训练系列产品 / Atlas A3 推理系列产品 | √ |
| Atlas A2 训练系列产品 / Atlas A2 推理系列产品 | √ |
| Atlas 200I/500 A2 推理产品 | ☓ |
| Atlas 推理系列产品 | ☓ |
| Atlas 训练系列产品 | ☓ |


#### 功能说明

添加探测目标，建立client与target之间的RPing通信链路。

其中client为发送端NPU，target为接收端NPU。


#### 函数原型

```
HccnResult HccnRpingAddTarget(HccnRpingCtx rpingCtx, uint32_t targetNum, HccnRpingTargetInfo *target)
```


#### 参数说明

| 参数名 | 输入/输出 | 描述 |
| --- | --- | --- |
| rpingCtx | 输入 | HccnRpingInit接口返回的RPing对象。 |
| targetNum | 输入 | 要添加的目标NPU数量，配置范围(0, 16]。 targetNum配置不能超过HccnRpingInit初始化时配置的参与RPing功能的NPU总数，即HccnRpingInitAttr对象中npuNum参数的值。 |
| target | 输入 | 建链所需的基本信息，包含目标NPU的监听端口、地址或标识信息，Client NPU需要的内存大小等信息。 HccnRpingTargetInfo类型的定义可参见HccnRpingTargetInfo。 |


#### 返回值

HccnResult类型错误码的解析结果。


#### 约束说明

- 若某个target添加失败，此接口会返回错误，导致全部target添加失败。
- targetNum必须和target数组深度保持一致，否则可能会触发访问越界的问题。
- 该接口一次最多支持添加16个target，若需要添加的target数量超过16个，则需要多次调用该接口实现。
- 调用该接口之后，如果目标target超过120s还没有通过  HccnRpingInit
接口初始化，会超时失败。