---
title: 函数：mem_set_pid_to_shareable_handle
description: "| 产品 | 是否支持 |"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/runtimeapi/aclpythondevg_01_0958.html
sourcePath: /source/zh/canncommercial/900/API/runtimeapi/aclpythondevg_01_0958.html
indexId: 7cfe7336a9c46e69d309110e03e3153542360e361d2551db90fa9b0c4ba7315a71
---
# 函数：mem_set_pid_to_shareable_handle

#### 产品支持情况

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


#### 功能说明

设置可共享内存的进程白名单，只有配置了白名单的进程才能用acl.rt.mem_export_to_shareable_handle接口导出的shareable_handle。

本接口需与其它接口配合使用，以便实现内存共享的目的，请参见acl.rt.mem_export_to_shareable_handle接口处的说明。


#### 函数原型

- C函数原型
  1 aclError aclrtMemSetPidToShareableHandle(uint64_t shareableHandle, int32_t *pid, size_t pidNum)

- python函数
  1 ret = acl.rt.mem_set_pid_to_shareable_handle(shareable_handle, pid)


#### 参数说明

| 参数名 | 说明 |
| --- | --- |
| shareable\_handle | int，通过acl.rt.mem\_export\_to\_shareable\_handle接口导出的shareable\_handle。 |
| pid | list，用于存放白名单进程ID的数组。 进程ID可调用acl.rt.device\_get\_bare\_tgid接口获取，Docker场景下获取到的是物理机上的进程ID，非Docker场景下获取到的是进程ID。 |


#### 返回值说明

| 返回值 | 说明 |
| --- | --- |
| ret | int，错误码，返回0表示成功，返回其它值表示失败。 |


#### 约束说明

在调用aclrtMemExportToShareableHandle接口的进程中，调用本接口设置进程白名单。

Ascend RC形态不支持调用本接口。