Class

NSXPCConnection

A bidirectional communication channel between two processes. ２つのプロセス間の双方向通信経路。

Declaration 宣言 

class NSXPCConnection : NSObject

Overview 概要

This class is the primary means of creating and configuring the communication mechanism between two processes. Each process has one instance of this class to represent the endpoint in the communication channel. このクラスは、２つのプロセス間での通信の仕組みを作成および構成設定する主要な手段です。各プロセスは、このクラスの１つのインスタンスを持つことで、通信経路における終端を表します。

Topics 話題

Creating Connections 接続を作成する

init(listenerEndpoint: NSXPCListenerEndpoint)
Initializes an NSXPCConnection object to connect to an NSXPCListener object in another process, identified by an NSXPCListenerEndpoint object. NSXPCConnectionオブジェクトを初期化して、別のプロセスにおけるNSXPCListenerオブジェクトに接続します、NSXPCListenerEndpointオブジェクトによって識別されます。
init(machServiceName: String, options: NSXPCConnection.Options)
Initializes an NSXPCConnection object to connect to a LaunchAgent or LaunchDaemon with a name advertised in a launchd.plist. NSXPCConnectionオブジェクトを初期化して、LaunchAgentまたはLaunchDaemonにlaunchd.plistにおいて宣伝される名前で接続します。
struct NSXPCConnection.Options
Options that you can pass to a connection. あなたがある接続に渡すことができるオプション。
init(serviceName: String)
Initializes an NSXPCConnection object to connect to an NSXPCListener object in an XPC service, identified by a service name. NSXPCConnectionオブジェクトを初期化して、XPCサービスにおけるNSXPCListenerオブジェクトに接続します、サービス名によって識別されます。

Error Codes さまざまなエラーコード

var NSXPCConnectionInterrupted: Int
The XPC connection was interrupted. XPC接続は中断されました。
var NSXPCConnectionInvalid: Int
The XPC connection was invalid. XPC接続は無効でした。
var NSXPCConnectionReplyInvalid: Int
The XPC connection reply was invalid. XPC接続応答は無効でした。
var NSXPCConnectionErrorMinimum: Int
The lower bounds of XPC connection error code values. XPC接続エラーコード値の下側の境界。
var NSXPCConnectionErrorMaximum: Int
The upper bounds of XPC connection error code values. XPC接続エラーコード値の上側の境界。

Instance Properties インスタンスプロパティ

var auditSessionIdentifier: au_asid_t
The BSM audit session identifier for the connecting process. 接続処理に対するBSM検査セッション識別子。
var effectiveGroupIdentifier: gid_t
The effective group ID (EGID) of the connecting process. 接続プロセスの実効グループID（EGID）。
var effectiveUserIdentifier: uid_t
The effective user ID (EUID) of the connecting process. 接続プロセスの実効ユーザID（EUID）。
var endpoint: NSXPCListenerEndpoint
If the connection was created with an NSXPCListenerEndpoint object, returns the endpoint object used. 接続がNSXPCListenerEndpointオブジェクトで作成されたならば、使用される終端点オブジェクトを返します。
var exportedInterface: NSXPCInterface?
The NSXPCInterface object that describes the protocol for the exported object on this connection. この接続に関するエクスポートオブジェクトに対するプロトコルを記述するNSXPCInterfaceオブジェクト。
var exportedObject: Any?
An exported object for the connection. この接続に対するエクスポートオブジェクト。
var interruptionHandler: (() -> Void)?
An interruption handler that is called if the remote process exits or crashes. リモートプロセスが退出またはクラッシュするならば呼び出される中断ハンドラ。
var invalidationHandler: (() -> Void)?
An invalidation handler that is called if the connection can not be formed or the connection has terminated and may not be re-established. 接続が形成されることができないまたは接続が切断されるそして再度確立されないかもしれないならば呼び出される無効化ハンドラ。
var processIdentifier: pid_t
The process ID (PID) of the connecting process. 接続プロセスのプロセスID（PID）。
var remoteObjectInterface: NSXPCInterface?
Defines the NSXPCInterface object that describes the protocol for the object represented by the remoteObjectProxy. NSXPCInterfaceオブジェクトを定義します、それはremoteObjectProxyによって表されるオブジェクトに対するプロトコルを記述します。
var remoteObjectProxy: Any
Returns a proxy for the remote object (that is, the exportedObject from the other side of this connection). リモートオブジェクトに対するプロキシを返します（すなわち、この接続の他の側からのexportedObject）。
var serviceName: String?
The name of the XPC service that this connection was configured to connect to. この接続がそれへと構成設定されたXPCサーバの名前。

Instance Methods インスタンス メソッド

func invalidate()
Invalidates the connection. 接続を無効にする
func remoteObjectProxyWithErrorHandler((Error) -> Void) -> Any
Returns a proxy for the remote object (that is, the object exported from the other side of this connection) with the specified error handler. リモートオブジェクトに対するプロキシ（すなわち、この接続の他の側からのエクスポートされるオブジェクト）をこの指定されたエラーハンドラとともに返します。
func resume()
Starts or resumes handling of messages on a connection. 接続におけるメッセージの取り扱いを開始または再開します。
func scheduleSendBarrierBlock(() -> Void)
func suspend()
Suspends the connection. 接続を待機させます。
func synchronousRemoteObjectProxyWithErrorHandler((Error) -> Void) -> Any

Type Methods 型メソッド

class func current() -> NSXPCConnection?

Relationships 関係

Inherits From 継承元

Conforms To 次に準拠

See Also 参照

XPC Client

protocol NSXPCProxyCreating
Methods for creating new proxy objects. 新しいプロキシオブジェクトを作成するためのメソッド。
class NSXPCInterface
An interface that may be sent to an exported object or remote object proxy. エクスポートオブジェクトまたはリモートオブジェクトプロキシに送られるかもしれないインターフェイス。
class NSXPCCoder
A coder that encodes and decodes objects that your app sends over an XPC connection. あるコーダー、それはあなたのアプリがXPC接続越しに送信するオブジェクトそれらをエンコードおよびデコードします。