harmony 鸿蒙OHIPCSkeleton

  • 2025-06-16
  • 浏览 (2)

OHIPCSkeleton

概述

提供IPC框架tokenId、凭据、PID/UID、线程池配置等功能C接口。

系统能力： SystemCapability.Communication.IPC.Core

起始版本： 12

汇总

文件

名称 描述
ipc_cskeleton.h 提供IPC框架tokenId、凭据、PID/UID、线程池配置等功能C接口。

函数

名称 描述
void OH_IPCSkeleton_JoinWorkThread (void) 当前线程加入IPC工作线程池。
void OH_IPCSkeleton_StopWorkThread (void) 当前线程退出IPC工作线程池。
uint64_t OH_IPCSkeleton_GetCallingTokenId (void) 获取调用方TokenId。该接口需要在IPC上下文中调用，否则返回自身TokenId。
uint64_t OH_IPCSkeleton_GetFirstTokenId (void) 获取首调者TokenId。
uint64_t OH_IPCSkeleton_GetSelfTokenId (void) 获取自身TokenId。
uint64_t OH_IPCSkeleton_GetCallingPid (void) 获取调用方进程ID。该接口需要在IPC上下文中调用，否则返回当前进程ID。
uint64_t OH_IPCSkeleton_GetCallingUid (void) 获取调用方用户ID。该接口需要在IPC上下文中调用，否则返回当前用户ID。
int OH_IPCSkeleton_IsLocalCalling (void) 判断是否正在进行本地调用。
int OH_IPCSkeleton_SetMaxWorkThreadNum (const int maxThreadNum) 设置最大工作线程数。
int OH_IPCSkeleton_ResetCallingIdentity (char **identity, int32_t *len, OH_IPC_MemAllocator allocator) 重置调用方身份凭证为自身进程的身份凭证（包括tokenid、UID和PID信息），并返回调用方的凭证信息。 该信息主要用于OH_IPCSkeleton_SetCallingIdentity接口调用。
int OH_IPCSkeleton_SetCallingIdentity (const char *identity) 恢复调用方凭证信息至IPC上下文中。
int OH_IPCSkeleton_IsHandlingTransaction (void) 是否正在处理IPC请求。

函数说明

OH_IPCSkeleton_GetCallingPid()

uint64_t OH_IPCSkeleton_GetCallingPid (void)

描述

获取调用方进程ID。该接口需要在IPC上下文中调用，否则返回当前进程ID。

系统能力： SystemCapability.Communication.IPC.Core

起始版本： 12

返回：

返回调用方进程ID。

OH_IPCSkeleton_GetCallingTokenId()

uint64_t OH_IPCSkeleton_GetCallingTokenId (void)

描述

获取调用方TokenId。该接口需要在IPC上下文中调用，否则返回自身TokenId。

系统能力： SystemCapability.Communication.IPC.Core

起始版本： 12

返回：

返回调用方TokenId。

OH_IPCSkeleton_GetCallingUid()

uint64_t OH_IPCSkeleton_GetCallingUid (void)

描述

获取调用方用户ID。该接口需要在IPC上下文中调用，否则返回当前用户ID。

系统能力： SystemCapability.Communication.IPC.Core

起始版本： 12

返回：

返回调用方用户ID。

OH_IPCSkeleton_GetFirstTokenId()

uint64_t OH_IPCSkeleton_GetFirstTokenId (void)

描述

获取首调者TokenId。

系统能力： SystemCapability.Communication.IPC.Core

起始版本： 12

返回：

返回首调者TokenId。

OH_IPCSkeleton_GetSelfTokenId()

uint64_t OH_IPCSkeleton_GetSelfTokenId (void)

描述

获取自身TokenId。

系统能力： SystemCapability.Communication.IPC.Core

起始版本： 12

返回：

返回自身TokenId。

OH_IPCSkeleton_IsHandlingTransaction()

int OH_IPCSkeleton_IsHandlingTransaction (void)

描述

是否正在处理IPC请求。

系统能力： SystemCapability.Communication.IPC.Core

起始版本： 12

返回：

正在处理IPC请求，返回1；否则，返回0。

OH_IPCSkeleton_IsLocalCalling()

int OH_IPCSkeleton_IsLocalCalling (void)

描述

判断是否正在进行本地调用。

系统能力： SystemCapability.Communication.IPC.Core

起始版本： 12

返回：

正在进行本地调用，返回1；否则，返回0。

OH_IPCSkeleton_JoinWorkThread()

void OH_IPCSkeleton_JoinWorkThread (void)

描述

当前线程加入IPC工作线程池。

系统能力： SystemCapability.Communication.IPC.Core

起始版本： 12

OH_IPCSkeleton_ResetCallingIdentity()

int OH_IPCSkeleton_ResetCallingIdentity (char ** identity, int32_t * len, OH_IPC_MemAllocator allocator)

描述

重置调用方身份凭证为自身进程的身份凭证（包括tokenid、UID和PID信息），并返回调用方的凭证信息。 该信息主要用于OH_IPCSkeleton_SetCallingIdentity接口调用。

系统能力： SystemCapability.Communication.IPC.Core

起始版本： 12

参数:

名称 描述
identity 用于存储调凭证的内存地址，该内存由用户提供的分配器进行内存分配，用户使用完后需要主动释放，不能为空。
len 写入identity的数据长度，不能为空。
allocator 用户指定的用来分配identity的内存分配器，不能为空。

返回：

成功返回OH_IPC_ErrorCode#OH_IPC_SUCCESS；

参数错误返回OH_IPC_ErrorCode#OH_IPC_CHECK_PARAM_ERROR；

内存分配失败返回OH_IPC_ErrorCode#OH_IPC_MEM_ALLOCATOR_ERROR；

其它情况返回OH_IPC_ErrorCode#OH_IPC_INNER_ERROR。

OH_IPCSkeleton_SetCallingIdentity()

int OH_IPCSkeleton_SetCallingIdentity (const char * identity)

描述

恢复调用方凭证信息至IPC上下文中。

系统能力： SystemCapability.Communication.IPC.Core

起始版本： 12

参数:

名称 描述
identity 调用方凭证，不能为空。来源于OH_IPCSkeleton_ResetCallingIdentity的返回值。

返回：

成功返回OH_IPC_ErrorCode#OH_IPC_SUCCESS；

参数错误返回OH_IPC_ErrorCode#OH_IPC_CHECK_PARAM_ERROR；

其它情况返回OH_IPC_ErrorCode#OH_IPC_INNER_ERROR。

OH_IPCSkeleton_SetMaxWorkThreadNum()

int OH_IPCSkeleton_SetMaxWorkThreadNum (const int maxThreadNum)

描述

设置最大工作线程数。

系统能力： SystemCapability.Communication.IPC.Core

起始版本： 12

参数:

名称 描述
maxThreadNum 最大工作线程数，默认16，范围:[1, 32]。

返回：

成功返回OH_IPC_ErrorCode#OH_IPC_SUCCESS；

参数错误返回OH_IPC_ErrorCode#OH_IPC_CHECK_PARAM_ERROR；

其它情况返回OH_IPC_ErrorCode#OH_IPC_INNER_ERROR。

OH_IPCSkeleton_StopWorkThread()

void OH_IPCSkeleton_StopWorkThread (void)

描述

当前线程退出IPC工作线程池。

系统能力： SystemCapability.Communication.IPC.Core

起始版本： 12

你可能感兴趣的鸿蒙文章

harmony 鸿蒙IPC Kit（进程间通信服务）

harmony 鸿蒙IPCKit

harmony 鸿蒙OH_IPC_MessageOption

harmony 鸿蒙OHIPCErrorCode

harmony 鸿蒙OHIPCParcel

harmony 鸿蒙OHIPCRemoteObject

harmony 鸿蒙RPC错误码

harmony 鸿蒙ipc_cparcel.h

harmony 鸿蒙ipc_cremote_object.h

harmony 鸿蒙ipc_cskeleton.h

0  赞
  • 所属分类： 后端技术
  • 本文标签： 软件 鸿蒙
  • 版权声明： 原创文章如转载，请注明本文链接: https://m.seaxiang.com/blog/GfdEB3
热门推荐
标签云
Linux Java Spring Spring Boot docker 大数据 前端 生活 maven golang 软件 spring cloud fintech mac vscode 其他 区块链 以太坊 V神 开发者 技术 股票 git greenplum 分布式事务 chrome mysql flink kafka 设计模式 原理 鸿蒙 seo
最新文章
本文目录