harmony 鸿蒙OHIPCParcel

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

OHIPCParcel

概述

提供IPC序列化/反序列化C接口。

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

起始版本： 12

汇总

文件

名称 描述
ipc_cparcel.h 提供IPC序列化/反序列化C接口。

类型定义

名称 描述
typedef void *(* OH_IPC_MemAllocator) (int32_t len) 内存分配函数类型。

函数

名称 描述
OHIPCParcel * OH_IPCParcel_Create (void) 创建OHIPCParcel对象，对象可序列化大小不能超过204800字节。
void OH_IPCParcel_Destroy (OHIPCParcel *parcel) 销毁OHIPCParcel对象。
int OH_IPCParcel_GetDataSize (const OHIPCParcel *parcel) 获取OHIPCParcel对象包含的数据的大小。
int OH_IPCParcel_GetWritableBytes (const OHIPCParcel *parcel) 获取OHIPCParcel对象可以写入的字节数。
int OH_IPCParcel_GetReadableBytes (const OHIPCParcel *parcel) 获取OHIPCParcel对象还可以读取的字节数。
int OH_IPCParcel_GetReadPosition (const OHIPCParcel *parcel) 获取OHIPCParcel对象当前读取位置。
int OH_IPCParcel_GetWritePosition (const OHIPCParcel *parcel) 获取OHIPCParcel对象当前写入位置。
int OH_IPCParcel_RewindReadPosition (OHIPCParcel *parcel, uint32_t newReadPos) 重置OHIPCParcel对象读取位置。
int OH_IPCParcel_RewindWritePosition (OHIPCParcel *parcel, uint32_t newWritePos) 重置OHIPCParcel对象写入位置。
int OH_IPCParcel_WriteInt8 (OHIPCParcel *parcel, int8_t value) 向OHIPCParcel对象写入int8_t值。
int OH_IPCParcel_ReadInt8 (const OHIPCParcel *parcel, int8_t *value) 从OHIPCParcel对象读取int8_t值。
int OH_IPCParcel_WriteInt16 (OHIPCParcel *parcel, int16_t value) 向OHIPCParcel对象写入int16_t值。
int OH_IPCParcel_ReadInt16 (const OHIPCParcel *parcel, int16_t *value) 从OHIPCParcel对象读取int16_t值。
int OH_IPCParcel_WriteInt32 (OHIPCParcel *parcel, int32_t value) 向OHIPCParcel对象写入int32_t值。
int OH_IPCParcel_ReadInt32 (const OHIPCParcel *parcel, int32_t *value) 从OHIPCParcel对象读取int32_t值。
int OH_IPCParcel_WriteInt64 (OHIPCParcel *parcel, int64_t value) 向OHIPCParcel对象写入int64_t值。
int OH_IPCParcel_ReadInt64 (const OHIPCParcel *parcel, int64_t *value) 从OHIPCParcel对象读取int64_t值。
int OH_IPCParcel_WriteFloat (OHIPCParcel *parcel, float value) 向OHIPCParcel对象写入float值。
int OH_IPCParcel_ReadFloat (const OHIPCParcel *parcel, float *value) 从OHIPCParcel对象读取float值。
int OH_IPCParcel_WriteDouble (OHIPCParcel *parcel, double value) 向OHIPCParcel对象写入double值。
int OH_IPCParcel_ReadDouble (const OHIPCParcel *parcel, double *value) 从OHIPCParcel对象读取double值。
int OH_IPCParcel_WriteString (OHIPCParcel *parcel, const char *str) 向OHIPCParcel对象写入字符串，包含字符串结束符。
const char * OH_IPCParcel_ReadString (const OHIPCParcel *parcel) 从OHIPCParcel对象读取字符串，用户可通过strlen获取字符串长度。
int OH_IPCParcel_WriteBuffer (OHIPCParcel *parcel, const uint8_t *buffer, int32_t len) 向OHIPCParcel对象写入指定长度的内存信息。
const uint8_t * OH_IPCParcel_ReadBuffer (const OHIPCParcel *parcel, int32_t len) 从OHIPCParcel对象读取指定长度内存信息。
int OH_IPCParcel_WriteRemoteStub (OHIPCParcel *parcel, const OHIPCRemoteStub *stub) 向OHIPCParcel对象写入OHIPCRemoteStub对象。
OHIPCRemoteStub * OH_IPCParcel_ReadRemoteStub (const OHIPCParcel *parcel) 从OHIPCParcel对象读取OHIPCRemoteStub对象。
int OH_IPCParcel_WriteRemoteProxy (OHIPCParcel *parcel, const OHIPCRemoteProxy *proxy) 向OHIPCParcel对象写入OHIPCRemoteProxy对象。
OHIPCRemoteProxy * OH_IPCParcel_ReadRemoteProxy (const OHIPCParcel *parcel) 从OHIPCParcel对象读取OHIPCRemoteProxy对象。
int OH_IPCParcel_WriteFileDescriptor (OHIPCParcel *parcel, int32_t fd) 向OHIPCParcel对象写入文件描述符。
int OH_IPCParcel_ReadFileDescriptor (const OHIPCParcel *parcel, int32_t *fd) 从OHIPCParcel对象读取文件描述符。
int OH_IPCParcel_Append (OHIPCParcel *parcel, const OHIPCParcel *data) OHIPCParcel对象数据拼接。
int OH_IPCParcel_WriteInterfaceToken (OHIPCParcel *parcel, const char *token) 向OHIPCParcel对象写入接口描述符，用于接口身份校验。
int OH_IPCParcel_ReadInterfaceToken (const OHIPCParcel *parcel, char **token, int32_t *len, OH_IPC_MemAllocator allocator) 从OHIPCParcel对象读取接口描述符信息，用于接口身份校验。

类型定义说明

OH_IPC_MemAllocator

typedef void*(* OH_IPC_MemAllocator) (int32_t len)

描述

内存分配函数类型。

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

起始版本： 12

参数:

名称 描述
len 分配内存长度。

返回：

成功返回分配的内存地址；失败返回NULL。

函数说明

OH_IPCParcel_Append()

int OH_IPCParcel_Append (OHIPCParcel * parcel, const OHIPCParcel * data)

描述

OHIPCParcel对象数据拼接。

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

起始版本： 12

参数:

名称 描述
parcel 拼接目标OHIPCParcel对象的指针，不能为空。
data 源OHIPCParcel对象的指针，不能为空。

返回：

成功返回OH_IPC_ErrorCode#OH_IPC_SUCCESS；

参数不合法时返回OH_IPC_ErrorCode#OH_IPC_CHECK_PARAM_ERROR；

拼接失败返回OH_IPC_ErrorCode#OH_IPC_PARCEL_WRITE_ERROR。

OH_IPCParcel_Create()

OHIPCParcel* OH_IPCParcel_Create (void)

描述

创建OHIPCParcel对象，对象可序列化大小不能超过204800字节。

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

起始版本： 12

返回：

成功返回OHIPCParcel对象指针；失败返回NULL。

OH_IPCParcel_Destroy()

void OH_IPCParcel_Destroy (OHIPCParcel * parcel)

描述

销毁OHIPCParcel对象。

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

起始版本： 12

参数:

名称 描述
parcel 需要销毁OHIPCParcel对象的指针。

OH_IPCParcel_GetDataSize()

int OH_IPCParcel_GetDataSize (const OHIPCParcel * parcel)

描述

获取OHIPCParcel对象包含的数据的大小。

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

起始版本： 12

参数:

名称 描述
parcel OHIPCParcel对象的指针，不能为空。

返回：

返回数据大小，参数不合法时返回-1。

OH_IPCParcel_GetReadableBytes()

int OH_IPCParcel_GetReadableBytes (const OHIPCParcel * parcel)

描述

获取OHIPCParcel对象还可以读取的字节数。

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

起始版本： 12

参数:

名称 描述
parcel OHIPCParcel对象的指针，不能为空。

返回：

返回可读字节数大小，参数不合法时返回-1。

OH_IPCParcel_GetReadPosition()

int OH_IPCParcel_GetReadPosition (const OHIPCParcel * parcel)

描述

获取OHIPCParcel对象当前读取位置。

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

起始版本： 12

参数:

名称 描述
parcel OHIPCParcel对象的指针，不能为空。

返回：

返回当前读位置，参数不合法时返回-1。

OH_IPCParcel_GetWritableBytes()

int OH_IPCParcel_GetWritableBytes (const OHIPCParcel * parcel)

描述

获取OHIPCParcel对象可以写入的字节数。

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

起始版本： 12

参数:

名称 描述
parcel OHIPCParcel对象的指针，不能为空。

返回：

返回可写字节数大小，参数不合法时返回-1。

OH_IPCParcel_GetWritePosition()

int OH_IPCParcel_GetWritePosition (const OHIPCParcel * parcel)

描述

获取OHIPCParcel对象当前写入位置。

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

起始版本： 12

参数:

名称 描述
parcel OHIPCParcel对象的指针，不能为空。

返回：

返回当前写入位置，参数不合法时返回-1。

OH_IPCParcel_ReadBuffer()

const uint8_t* OH_IPCParcel_ReadBuffer (const OHIPCParcel * parcel, int32_t len)

描述

从OHIPCParcel对象读取指定长度内存信息。

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

起始版本： 12

参数:

名称 描述
parcel OHIPCParcel对象的指针，不能为空。
len 读取内存的长度。

返回：

成功返回读取到的内存地址；参数不合法或len超过parcel可读长度时返回NULL。

OH_IPCParcel_ReadDouble()

int OH_IPCParcel_ReadDouble (const OHIPCParcel * parcel, double * value)

描述

从OHIPCParcel对象读取double值。

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

起始版本： 12

参数:

名称 描述
parcel OHIPCParcel对象的指针，不能为空。
value 存储读取数据的指针，不能为空。

返回：

成功返回OH_IPC_ErrorCode#OH_IPC_SUCCESS；

参数不合法时返回OH_IPC_ErrorCode#OH_IPC_CHECK_PARAM_ERROR；

读取失败返回OH_IPC_ErrorCode#OH_IPC_PARCEL_READ_ERROR。

OH_IPCParcel_ReadFileDescriptor()

int OH_IPCParcel_ReadFileDescriptor (const OHIPCParcel * parcel, int32_t * fd)

描述

从OHIPCParcel对象读取文件描述符。

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

起始版本： 12

参数:

名称 描述
parcel OHIPCParcel对象的指针，不能为空。
fd 存储读取文件描述符的指针，不能为空。

返回：

成功返回OH_IPC_ErrorCode#OH_IPC_SUCCESS；

参数不合法时返回OH_IPC_ErrorCode#OH_IPC_CHECK_PARAM_ERROR；

读取失败返回OH_IPC_ErrorCode#OH_IPC_PARCEL_READ_ERROR。

OH_IPCParcel_ReadFloat()

int OH_IPCParcel_ReadFloat (const OHIPCParcel * parcel, float * value)

描述

从OHIPCParcel对象读取float值。

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

起始版本： 12

参数:

名称 描述
parcel OHIPCParcel对象的指针，不能为空。
value 存储读取数据的指针，不能为空。

返回：

成功返回OH_IPC_ErrorCode#OH_IPC_SUCCESS；

参数不合法时返回OH_IPC_ErrorCode#OH_IPC_CHECK_PARAM_ERROR；

读取失败返回OH_IPC_ErrorCode#OH_IPC_PARCEL_READ_ERROR。

OH_IPCParcel_ReadInt16()

int OH_IPCParcel_ReadInt16 (const OHIPCParcel * parcel, int16_t * value)

描述

从OHIPCParcel对象读取int16_t值。

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

起始版本： 12

参数:

名称 描述
parcel OHIPCParcel对象的指针，不能为空。
value 存储读取数据的指针，不能为空。

返回：

成功返回OH_IPC_ErrorCode#OH_IPC_SUCCESS；

参数不合法时返回OH_IPC_ErrorCode#OH_IPC_CHECK_PARAM_ERROR；

读取失败返回OH_IPC_ErrorCode#OH_IPC_PARCEL_READ_ERROR。

OH_IPCParcel_ReadInt32()

int OH_IPCParcel_ReadInt32 (const OHIPCParcel * parcel, int32_t * value)

描述

从OHIPCParcel对象读取int32_t值。

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

起始版本： 12

参数:

名称 描述
parcel OHIPCParcel对象的指针，不能为空。
value 存储读取数据的指针，不能为空。

返回：

成功返回OH_IPC_ErrorCode#OH_IPC_SUCCESS；

参数不合法时返回OH_IPC_ErrorCode#OH_IPC_CHECK_PARAM_ERROR；

读取失败返回OH_IPC_ErrorCode#OH_IPC_PARCEL_READ_ERROR。

OH_IPCParcel_ReadInt64()

int OH_IPCParcel_ReadInt64 (const OHIPCParcel * parcel, int64_t * value)

描述

从OHIPCParcel对象读取int64_t值。

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

起始版本： 12

参数:

名称 描述
parcel OHIPCParcel对象的指针，不能为空。
value 存储读取数据的指针，不能为空。

返回：

成功返回OH_IPC_ErrorCode#OH_IPC_SUCCESS；

参数不合法时返回OH_IPC_ErrorCode#OH_IPC_CHECK_PARAM_ERROR；

读取失败返回OH_IPC_ErrorCode#OH_IPC_PARCEL_READ_ERROR。

OH_IPCParcel_ReadInt8()

int OH_IPCParcel_ReadInt8 (const OHIPCParcel * parcel, int8_t * value)

描述

从OHIPCParcel对象读取int8_t值。

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

起始版本： 12

参数:

名称 描述
parcel OHIPCParcel对象的指针，不能为空。
value 存储读取数据的指针，不能为空。

返回：

成功返回OH_IPC_ErrorCode#OH_IPC_SUCCESS；

参数不合法时返回OH_IPC_ErrorCode#OH_IPC_CHECK_PARAM_ERROR；

读取失败返回OH_IPC_ErrorCode#OH_IPC_PARCEL_READ_ERROR。

OH_IPCParcel_ReadInterfaceToken()

int OH_IPCParcel_ReadInterfaceToken (const OHIPCParcel * parcel, char ** token, int32_t * len, OH_IPC_MemAllocator allocator)

描述

从OHIPCParcel对象读取接口描述符信息，用于接口身份校验。

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

起始版本： 12

参数:

名称 描述
parcel OHIPCParcel对象的指针，不能为空。
token 用于存储接口描述符信息的内存地址，该内存由用户提供的分配器进行内存分配，用户使用完后需要主动释放，不能为空。 接口返回失败时，用户依然需要判断该内存是否为空，并主动释放，否则会造成内存泄漏。
len 存储读取接口描述符的长度，包含结束符，不能为空。
allocator 用户指定的用来分配token的内存分配器，不能为空。

返回：

成功返回OH_IPC_ErrorCode#OH_IPC_SUCCESS；

参数不合法时返回OH_IPC_ErrorCode#OH_IPC_CHECK_PARAM_ERROR；

读取失败返回OH_IPC_ErrorCode#OH_IPC_PARCEL_READ_ERROR。

OH_IPCParcel_ReadRemoteProxy()

OHIPCRemoteProxy* OH_IPCParcel_ReadRemoteProxy (const OHIPCParcel * parcel)

描述

从OHIPCParcel对象读取OHIPCRemoteProxy对象。

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

起始版本： 12

参数:

名称 描述
parcel OHIPCParcel对象的指针，不能为空。

返回：

成功返回OHIPCRemoteProxy对象指针；失败返回NULL。

OH_IPCParcel_ReadRemoteStub()

OHIPCRemoteStub* OH_IPCParcel_ReadRemoteStub (const OHIPCParcel * parcel)

描述

从OHIPCParcel对象读取OHIPCRemoteStub对象。

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

起始版本： 12

参数:

名称 描述
parcel OHIPCParcel对象的指针，不能为空。

返回：

成功返回OHIPCRemoteStub对象指针；失败返回NULL。

OH_IPCParcel_ReadString()

const char* OH_IPCParcel_ReadString (const OHIPCParcel * parcel)

描述

从OHIPCParcel对象读取字符串，用户可通过strlen获取字符串长度。

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

起始版本： 12

参数:

名称 描述
parcel OHIPCParcel对象的指针，不能为空。

返回：

成功返回读取字符串地址；参数不合法或读取失败时返回NULL。

OH_IPCParcel_RewindReadPosition()

int OH_IPCParcel_RewindReadPosition (OHIPCParcel * parcel, uint32_t newReadPos)

描述

重置OHIPCParcel对象读取位置。

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

起始版本： 12

参数:

名称 描述
parcel OHIPCParcel对象的指针，不能为空。
newReadPos 新的读取位置，范围：[0, 当前数据大小]。

返回：

成功返回OH_IPC_ErrorCode#OH_IPC_SUCCESS；

参数不合法时返回OH_IPC_ErrorCode#OH_IPC_CHECK_PARAM_ERROR。

OH_IPCParcel_RewindWritePosition()

int OH_IPCParcel_RewindWritePosition (OHIPCParcel * parcel, uint32_t newWritePos)

描述

重置OHIPCParcel对象写入位置。

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

起始版本： 12

参数:

名称 描述
parcel OHIPCParcel对象的指针，不能为空。
newWritePos 新的写入位置，范围：[0, 当前数据大小]。

返回：

成功返回OH_IPC_ErrorCode#OH_IPC_SUCCESS；

参数不合法时返回OH_IPC_ErrorCode#OH_IPC_CHECK_PARAM_ERROR。

OH_IPCParcel_WriteBuffer()

int OH_IPCParcel_WriteBuffer (OHIPCParcel * parcel, const uint8_t * buffer, int32_t len)

描述

向OHIPCParcel对象写入指定长度的内存信息。

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

起始版本： 12

参数:

名称 描述
parcel OHIPCParcel对象的指针，不能为空。
buffer 写入内存信息地址。
len 写入信息长度。

返回：

成功返回OH_IPC_ErrorCode#OH_IPC_SUCCESS；

参数不合法时返回OH_IPC_ErrorCode#OH_IPC_CHECK_PARAM_ERROR；

写入失败返回OH_IPC_ErrorCode#OH_IPC_PARCEL_WRITE_ERROR。

OH_IPCParcel_WriteDouble()

int OH_IPCParcel_WriteDouble (OHIPCParcel * parcel, double value)

描述

向OHIPCParcel对象写入double值。

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

起始版本： 12

参数:

名称 描述
parcel OHIPCParcel对象的指针，不能为空。
value 要写入的值。

返回：

成功返回OH_IPC_ErrorCode#OH_IPC_SUCCESS；

参数不合法时返回OH_IPC_ErrorCode#OH_IPC_CHECK_PARAM_ERROR；

写入失败返回OH_IPC_ErrorCode#OH_IPC_PARCEL_WRITE_ERROR。

OH_IPCParcel_WriteFileDescriptor()

int OH_IPCParcel_WriteFileDescriptor (OHIPCParcel * parcel, int32_t fd)

描述

向OHIPCParcel对象写入文件描述符。

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

起始版本： 12

参数:

名称 描述
parcel OHIPCParcel对象的指针，不能为空。
fd 要写入的文件描述符。

返回：

成功返回OH_IPC_ErrorCode#OH_IPC_SUCCESS；

参数不合法时返回OH_IPC_ErrorCode#OH_IPC_CHECK_PARAM_ERROR；

写入失败返回OH_IPC_ErrorCode#OH_IPC_PARCEL_WRITE_ERROR。

OH_IPCParcel_WriteFloat()

int OH_IPCParcel_WriteFloat (OHIPCParcel * parcel, float value)

描述

向OHIPCParcel对象写入float值。

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

起始版本： 12

参数:

名称 描述
parcel OHIPCParcel对象的指针，不能为空。
value 要写入的值。

返回：

成功返回OH_IPC_ErrorCode#OH_IPC_SUCCESS；

参数不合法时返回OH_IPC_ErrorCode#OH_IPC_CHECK_PARAM_ERROR；

写入失败返回OH_IPC_ErrorCode#OH_IPC_PARCEL_WRITE_ERROR。

OH_IPCParcel_WriteInt16()

int OH_IPCParcel_WriteInt16 (OHIPCParcel * parcel, int16_t value)

描述

向OHIPCParcel对象写入int16_t值。

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

起始版本： 12

参数:

名称 描述
parcel OHIPCParcel对象的指针，不能为空。
value 要写入的值。

返回：

成功返回OH_IPC_ErrorCode#OH_IPC_SUCCESS；

参数不合法时返回OH_IPC_ErrorCode#OH_IPC_CHECK_PARAM_ERROR；

写入失败返回OH_IPC_ErrorCode#OH_IPC_PARCEL_WRITE_ERROR。

OH_IPCParcel_WriteInt32()

int OH_IPCParcel_WriteInt32 (OHIPCParcel * parcel, int32_t value)

描述

向OHIPCParcel对象写入int32_t值。

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

起始版本： 12

参数:

名称 描述
parcel OHIPCParcel对象的指针，不能为空。
value 要写入的值。

返回：

成功返回OH_IPC_ErrorCode#OH_IPC_SUCCESS；

参数不合法时返回OH_IPC_ErrorCode#OH_IPC_CHECK_PARAM_ERROR；

写入失败返回OH_IPC_ErrorCode#OH_IPC_PARCEL_WRITE_ERROR。

OH_IPCParcel_WriteInt64()

int OH_IPCParcel_WriteInt64 (OHIPCParcel * parcel, int64_t value)

描述

向OHIPCParcel对象写入int64_t值。

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

起始版本： 12

参数:

名称 描述
parcel OHIPCParcel对象的指针，不能为空。
value 要写入的值。

返回：

成功返回OH_IPC_ErrorCode#OH_IPC_SUCCESS；

参数不合法时返回OH_IPC_ErrorCode#OH_IPC_CHECK_PARAM_ERROR；

写入失败返回OH_IPC_ErrorCode#OH_IPC_PARCEL_WRITE_ERROR。

OH_IPCParcel_WriteInt8()

int OH_IPCParcel_WriteInt8 (OHIPCParcel * parcel, int8_t value)

描述

向OHIPCParcel对象写入int8_t值。

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

起始版本： 12

参数:

名称 描述
parcel OHIPCParcel对象的指针，不能为空。
value 要写入的值。

返回：

成功返回OH_IPC_ErrorCode#OH_IPC_SUCCESS；

参数不合法时返回OH_IPC_ErrorCode#OH_IPC_CHECK_PARAM_ERROR；

写入失败返回OH_IPC_ErrorCode#OH_IPC_PARCEL_WRITE_ERROR。

OH_IPCParcel_WriteInterfaceToken()

int OH_IPCParcel_WriteInterfaceToken (OHIPCParcel * parcel, const char * token)

描述

向OHIPCParcel对象写入接口描述符，用于接口身份校验。

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

起始版本： 12

参数:

名称 描述
parcel OHIPCParcel对象的指针，不能为空。
token 需要写入的接口描述符信息，不能为空。

返回：

成功返回OH_IPC_ErrorCode#OH_IPC_SUCCESS；

参数不合法时返回OH_IPC_ErrorCode#OH_IPC_CHECK_PARAM_ERROR；

写入失败返回OH_IPC_ErrorCode#OH_IPC_PARCEL_WRITE_ERROR。

OH_IPCParcel_WriteRemoteProxy()

int OH_IPCParcel_WriteRemoteProxy (OHIPCParcel * parcel, const OHIPCRemoteProxy * proxy)

描述

向OHIPCParcel对象写入OHIPCRemoteProxy对象。

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

起始版本： 12

参数:

名称 描述
parcel OHIPCParcel对象的指针，不能为空。
proxy 需要写入的OHIPCRemoteProxy对象指针，不能为空。

返回：

成功返回OH_IPC_ErrorCode#OH_IPC_SUCCESS；

参数不合法时返回OH_IPC_ErrorCode#OH_IPC_CHECK_PARAM_ERROR；

写入失败返回OH_IPC_ErrorCode#OH_IPC_PARCEL_WRITE_ERROR。

OH_IPCParcel_WriteRemoteStub()

int OH_IPCParcel_WriteRemoteStub (OHIPCParcel * parcel, const OHIPCRemoteStub * stub)

描述

向OHIPCParcel对象写入OHIPCRemoteStub对象。

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

起始版本： 12

参数:

名称 描述
parcel OHIPCParcel对象的指针，不能为空。
stub 需要写入的OHIPCRemoteStub对象指针，不能为空。

返回：

成功返回OH_IPC_ErrorCode#OH_IPC_SUCCESS；

参数不合法时返回OH_IPC_ErrorCode#OH_IPC_CHECK_PARAM_ERROR；

写入失败返回OH_IPC_ErrorCode#OH_IPC_PARCEL_WRITE_ERROR。

OH_IPCParcel_WriteString()

int OH_IPCParcel_WriteString (OHIPCParcel * parcel, const char * str)

描述

向OHIPCParcel对象写入字符串，包含字符串结束符。

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

起始版本： 12

参数:

名称 描述
parcel OHIPCParcel对象的指针，不能为空。
str 写入字符串，不能为空。

返回：

成功返回OH_IPC_ErrorCode#OH_IPC_SUCCESS；

参数不合法时返回OH_IPC_ErrorCode#OH_IPC_CHECK_PARAM_ERROR；

写入失败返回OH_IPC_ErrorCode#OH_IPC_PARCEL_WRITE_ERROR。

你可能感兴趣的鸿蒙文章

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

harmony 鸿蒙IPCKit

harmony 鸿蒙OH_IPC_MessageOption

harmony 鸿蒙OHIPCErrorCode

harmony 鸿蒙OHIPCRemoteObject

harmony 鸿蒙OHIPCSkeleton

harmony 鸿蒙RPC错误码

harmony 鸿蒙ipc_cparcel.h

harmony 鸿蒙ipc_cremote_object.h

harmony 鸿蒙ipc_cskeleton.h

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