程序包 ohos.rpc

类 IPCSkeleton

java.lang.Object

ohos.rpc.IPCSkeleton

public class IPCSkeleton
extends Object

Provides static interfaces in the IPC skeleton to obtain services, read and write objects, obtain the UID and PID, obtain the IDs of local and peer devices, and check whether an interface call is made on the same device.

从以下版本开始:

1

构造器概要

构造器

构造器	说明
IPCSkeleton()

方法概要

限定符和类型	方法	说明
static int	flushCommands(IRemoteObject object)	Flushes all pending commands from a specified RemoteProxy to the corresponding RemoteObject.
static String	getCallingDeviceID()	Obtains the ID of the device where the peer process resides.
static int	getCallingPid()	Obtains the PID of a proxy.
static int	getCallingUid()	Obtains the UID of a proxy.
static IRemoteObject	getContextObject()	Obtains a local IRemoteObject reference of a registered service.
static String	getLocalDeviceID()	Obtains the ID of the local device.
static boolean	isLocalCalling()	Checks whether a call is made on the same device.
static String	resetCallingIdentity()	Replaces the UID and PID of the remote user with those of the local user.
static boolean	setCallingIdentity(String identity)	Restores the UID and PID to those of the remote user.

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

IPCSkeleton

public IPCSkeleton()

方法详细资料

getContextObject

public static IRemoteObject getContextObject()

Obtains a local IRemoteObject reference of a registered service.

This method is static.

返回:

Returns an IRemoteObject reference of the registered service.

从以下版本开始:

1

getCallingPid

public static int getCallingPid()

Obtains the PID of a proxy.

This method is static. The PID is a positive integer during the communication between the RemoteProxy object and RemoteObject object, and resumes to 0 when the communication ends. If this method is called from the RemoteProxy object, 0 is returned; if this method is called from the RemoteObject object, the PID of the corresponding RemoteProxy object is returned.

返回:

Returns the PID of the proxy.

从以下版本开始:

1

getCallingUid

public static int getCallingUid()

Obtains the UID of a proxy.

This method is static. The UID is a positive integer during the communication between the RemoteProxy object and RemoteObject object, and resumes to 0 when the communication ends. If this method is called from the RemoteProxy object, 0 is returned; if this method is called from the RemoteObject object, the UID of the corresponding RemoteProxy object is returned.

返回:

Returns the UID of the proxy.

从以下版本开始:

1

getCallingDeviceID

public static String getCallingDeviceID()

Obtains the ID of the device where the peer process resides.

This method is static.

返回:

Returns the ID of the device where the peer process resides.

从以下版本开始:

1

getLocalDeviceID

public static String getLocalDeviceID()

Obtains the ID of the local device.

This method is static.

返回:

Returns the ID of the local device.

从以下版本开始:

1

isLocalCalling

public static boolean isLocalCalling()

Checks whether a call is made on the same device.

This method is static.

返回:

Returns true if the call is made on the same device; returns false otherwise.

从以下版本开始:

1

flushCommands

public static int flushCommands(IRemoteObject object)

Flushes all pending commands from a specified RemoteProxy to the corresponding RemoteObject.

This method is static. You are advised to call this method before performing any time-sensitive operations.

参数:

object - Indicates the specified RemoteProxy.

返回:

Returns 0 if the operation succeeds; returns an error code if the input object is empty or RemoteObject, or the operation fails.

从以下版本开始:

1

resetCallingIdentity

public static String resetCallingIdentity()

Replaces the UID and PID of the remote user with those of the local user.

This method is static. It can be used in scenarios like authentication.

返回:

Returns a string containing the UID and PID of the remote user.

从以下版本开始:

1

setCallingIdentity

public static boolean setCallingIdentity(String identity)

Restores the UID and PID to those of the remote user.

This method is static. It is usually called after resetCallingIdentity is used and requires the UID and PID of the remote user returned by resetCallingIdentity.

参数:

identity - Indicates the string containing the UID and PID of the remote user, which is returned by resetCallingIdentity.

返回:

Returns true if the operation succeeds; returns false otherwise.

从以下版本开始:

1