harmony 鸿蒙ipc_cremote_object.h

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

ipc_cremote_object.h

概述

提供远端对象创建、销毁、数据发送、远端对象死亡状态监听等功能的C接口。

库: libipc_capi.so

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

起始版本: 12

相关模块:OHIPCRemoteObject

所在头文件: ipc_cremote_object.h

汇总

结构体

名称 描述
struct  OH_IPC_MessageOption IPC消息选项定义。

类型定义

名称 描述
typedef int(* OH_OnRemoteRequestCallback) (uint32_t code, const OHIPCParcel *data, OHIPCParcel *reply, void *userData) Stub端用于处理远端数据请求的回调函数。
typedef void(* OH_OnRemoteDestroyCallback) (void *userData) Stub端用于监听对象销毁的回调函数。
typedef void(* OH_OnDeathRecipientCallback) (void *userData) 远端OHIPCRemoteStub对象死亡通知的回调函数类型。
typedef void(* OH_OnDeathRecipientDestroyCallback) (void *userData) OHIPCDeathRecipient对象销毁回调函数类型。

枚举

名称 描述
OH_IPC_RequestMode {
OH_IPC_REQUEST_MODE_SYNC = 0,
OH_IPC_REQUEST_MODE_ASYNC = 1
}
IPC请求模式定义。

函数

名称 描述
OHIPCRemoteStub * OH_IPCRemoteStub_Create (const char *descriptor, OH_OnRemoteRequestCallback requestCallback, OH_OnRemoteDestroyCallback destroyCallback, void *userData) 创建OHIPCRemoteStub对象。
void OH_IPCRemoteStub_Destroy (OHIPCRemoteStub *stub) 销毁OHIPCRemoteStub对象。
void OH_IPCRemoteProxy_Destroy (OHIPCRemoteProxy *proxy) 销毁OHIPCRemoteProxy对象。
int OH_IPCRemoteProxy_SendRequest (const OHIPCRemoteProxy *proxy, uint32_t code, const OHIPCParcel *data, OHIPCParcel *reply, const OH_IPC_MessageOption *option) IPC消息发送函数。
int OH_IPCRemoteProxy_GetInterfaceDescriptor (OHIPCRemoteProxy *proxy, char **descriptor, int32_t *len, OH_IPC_MemAllocator allocator) 从Stub端获取接口描述符。
OHIPCDeathRecipient * OH_IPCDeathRecipient_Create (OH_OnDeathRecipientCallback deathRecipientCallback, OH_OnDeathRecipientDestroyCallback destroyCallback, void *userData) 创建远端OHIPCRemoteStub对象死亡通知对象OHIPCDeathRecipient。
void OH_IPCDeathRecipient_Destroy (OHIPCDeathRecipient *recipient) 销毁OHIPCDeathRecipient对象。
int OH_IPCRemoteProxy_AddDeathRecipient (OHIPCRemoteProxy *proxy, OHIPCDeathRecipient *recipient) 向OHIPCRemoteProxy对象添加死亡监听,用于接收远端OHIPCRemoteStub对象死亡的回调通知。
int OH_IPCRemoteProxy_RemoveDeathRecipient (OHIPCRemoteProxy *proxy, OHIPCDeathRecipient *recipient) 移除向OHIPCRemoteProxy对象已经添加的死亡监听。
int OH_IPCRemoteProxy_IsRemoteDead (const OHIPCRemoteProxy *proxy) 判断OHIPCRemoteProxy对象对应的远端OHIPCRemoteStub对象是否死亡。

你可能感兴趣的鸿蒙文章

harmony 鸿蒙IPC Kit(进程间通信服务)

harmony 鸿蒙IPCKit

harmony 鸿蒙OH_IPC_MessageOption

harmony 鸿蒙OHIPCErrorCode

harmony 鸿蒙OHIPCParcel

harmony 鸿蒙OHIPCRemoteObject

harmony 鸿蒙OHIPCSkeleton

harmony 鸿蒙RPC错误码

harmony 鸿蒙ipc_cparcel.h

harmony 鸿蒙ipc_cskeleton.h

0  赞