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

#### 产品支持情况

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


#### 功能说明

添加探测目标，建立client与target之间的RPing通信链路，支持RPing超时时间可配置。

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


#### 函数原型

```
HccnResult HccnRpingAddTargetWithCfg(HccnRpingCtx rpingCtx, uint32_t targetNum, HccnRpingTargetInfo *target, HccnRpingAddTargetConfig *config)
```


#### 参数说明

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


#### 返回值

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


#### 约束说明

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