Class

NSXPCConnection

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

Declaration 宣言 

@interface 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 接続を作成する

- initWithListenerEndpoint:
Initializes an NSXPCConnection object to connect to an NSXPCListener object in another process, identified by an NSXPCListenerEndpoint object. NSXPCConnectionオブジェクトを初期化して、別のプロセスにおけるNSXPCListenerオブジェクトに接続します、NSXPCListenerEndpointオブジェクトによって識別されます。
- initWithMachServiceName: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において宣伝される名前で接続します。
NSXPCConnectionOptions
Options that you can pass to a connection. あなたがある接続に渡すことができるオプション。
- initWithServiceName:
Initializes an NSXPCConnection object to connect to an NSXPCListener object in an XPC service, identified by a service name. NSXPCConnectionオブジェクトを初期化して、XPCサービスにおけるNSXPCListenerオブジェクトに接続します、サービス名によって識別されます。

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

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

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

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

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

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

Type Methods 型メソッド

+ currentConnection

Relationships 関係

Inherits From 継承元

Conforms To 次に準拠

See Also 参照

XPC Client

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