1e41f4b71Sopenharmony_ci# native_child_process.h 2e41f4b71Sopenharmony_ci 3e41f4b71Sopenharmony_ci 4e41f4b71Sopenharmony_ci## 概述 5e41f4b71Sopenharmony_ci 6e41f4b71Sopenharmony_ci支持创建Native子进程，并在父子进程间建立IPC通道。通过此模块和[childProcessManager](js-apis-app-ability-childProcessManager.md)（非SELF_FORK模式）可以启动的子进程总数最大为512个。 7e41f4b71Sopenharmony_ci 8e41f4b71Sopenharmony_ci**库：** libchild_process.so 9e41f4b71Sopenharmony_ci 10e41f4b71Sopenharmony_ci**系统能力：** SystemCapability.Ability.AbilityRuntime.Core 11e41f4b71Sopenharmony_ci 12e41f4b71Sopenharmony_ci**起始版本：** 12 13e41f4b71Sopenharmony_ci 14e41f4b71Sopenharmony_ci**相关模块：**[ChildProcess](c-apis-ability-childprocess.md) 15e41f4b71Sopenharmony_ci 16e41f4b71Sopenharmony_ci 17e41f4b71Sopenharmony_ci## 汇总 18e41f4b71Sopenharmony_ci 19e41f4b71Sopenharmony_ci### 文件 20e41f4b71Sopenharmony_ci 21e41f4b71Sopenharmony_ci| 名称 | 描述 | 22e41f4b71Sopenharmony_ci| ------------------------------------------------------ | -------------------------------------------------------------------------------------------------- | 23e41f4b71Sopenharmony_ci| [native_child_process.h](native__child__process_8h.md) | 支持创建Native子进程，并在父子进程间建立IPC通道。<br>引用文件：<AbilityKit/native_child_process.h><br>库：libchild_process.so | 24e41f4b71Sopenharmony_ci 25e41f4b71Sopenharmony_ci### 类型定义 26e41f4b71Sopenharmony_ci 27e41f4b71Sopenharmony_ci| 名称 | 描述 | 28e41f4b71Sopenharmony_ci| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------- | 29e41f4b71Sopenharmony_ci| typedef enum Ability_NativeChildProcess_ErrCode [Ability_NativeChildProcess_ErrCode](c-apis-ability-childprocess.md#ability_nativechildprocess_errcode) | 定义Native子进程模块错误码。 | 30e41f4b71Sopenharmony_ci| typedef void(\* [OH_Ability_OnNativeChildProcessStarted](c-apis-ability-childprocess.md#oh_ability_onnativechildprocessstarted)) (int errCode, OHIPCRemoteProxy \*remoteProxy) | 定义通知子进程启动结果的回调函数。 | 31e41f4b71Sopenharmony_ci| typedef struct [NativeChildProcess_Fd](c-apis-ability-childprocess.md#nativechildprocess_fd) | 定义子进程文件描述符记录。 | 32e41f4b71Sopenharmony_ci| typedef struct [NativeChildProcess_FdList](c-apis-ability-childprocess.md#nativechildprocess_fdlist) | 定义子进程文件描述符记录链表。 | 33e41f4b71Sopenharmony_ci| typedef struct [NativeChildProcess_Args](c-apis-ability-childprocess.md#nativechildprocess_args) | 定义启动子进程入参。 | 34e41f4b71Sopenharmony_ci| typedef struct [NativeChildProcess_Options](c-apis-ability-childprocess.md#nativechildprocess_options) | 定义子进程选项。 | 35e41f4b71Sopenharmony_ci 36e41f4b71Sopenharmony_ci 37e41f4b71Sopenharmony_ci### 枚举 38e41f4b71Sopenharmony_ci 39e41f4b71Sopenharmony_ci| 名称 | 描述 | 40e41f4b71Sopenharmony_ci| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- | 41e41f4b71Sopenharmony_ci| [Ability_NativeChildProcess_ErrCode](c-apis-ability-childprocess.md#ability_nativechildprocess_errcode) {<br> NCP_NO_ERROR = 0,<br> NCP_ERR_INVALID_PARAM = 401,<br> NCP_ERR_NOT_SUPPORTED = 801,<br> NCP_ERR_INTERNAL = 16000050,<br> NCP_ERR_BUSY = 16010001,<br> NCP_ERR_TIMEOUT = 16010002,<br> NCP_ERR_SERVICE_ERROR = 16010003,<br> NCP_ERR_MULTI_PROCESS_DISABLED = 16010004,<br> NCP_ERR_ALREADY_IN_CHILD = 16010005,<br> NCP_ERR_MAX_CHILD_PROCESSES_REACHED = 16010006,<br> NCP_ERR_LIB_LOADING_FAILED = 16010007,<br> NCP_ERR_CONNECTION_FAILED = 16010008<br>} | 定义Native子进程模块错误码。 | 42e41f4b71Sopenharmony_ci| [NativeChildProcess_IsolationMode](c-apis-ability-childprocess.md#nativechildprocess_isolationmode) {<br> NCP_ISOLATION_MODE_NORMAL = 0,<br> NCP_ISOLATION_MODE_ISOLATED = 1,<br>} | 定义子进程独立模式。 | 43e41f4b71Sopenharmony_ci 44e41f4b71Sopenharmony_ci 45e41f4b71Sopenharmony_ci### 函数 46e41f4b71Sopenharmony_ci 47e41f4b71Sopenharmony_ci| 名称 | 描述 | 48e41f4b71Sopenharmony_ci| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | 49e41f4b71Sopenharmony_ci| int [OH_Ability_CreateNativeChildProcess](c-apis-ability-childprocess.md#oh_ability_createnativechildprocess) (const char \*libName, [OH_Ability_OnNativeChildProcessStarted](c-apis-ability-childprocess.md#oh_ability_onnativechildprocessstarted) onProcessStarted) | 创建子进程并加载参数中指定的动态链接库文件，进程启动结果通过回调参数异步通知，需注意回调通知为独立线程，回调函数实现需要注意线程同步，且不能执行高耗时操作避免长时间阻塞。 <br/><b>说明：</b>当前仅支持2in1设备，且单个进程通过此函数只能启动一个Native子进程。| 50e41f4b71Sopenharmony_ci| [Ability_NativeChildProcess_ErrCode](c-apis-ability-childprocess.md#ability_nativechildprocess_errcode) [OH_Ability_StartNativeChildProcess](c-apis-ability-childprocess.md#oh_ability_startnativechildprocess)(const char\* entry, [NativeChildProcess_Args](c-apis-ability-childprocess.md#nativechildprocess_args) args, [NativeChildProcess_Options](c-apis-ability-childprocess.md#nativechildprocess_options) options, int32_t *pid) | 启动子进程，加载参数中指定的动态链接库文件并调用入口函数。支持传参到子进程。<br/><b>说明：</b>当前仅支持2in1、tablet设备。|