NSXPCProxyCreating Protocol Reference

Framework
/System/Library/Frameworks/Foundation.framework
Availability
Available in OS X v10.8 and later.
Declared in
NSXPCConnection.h

Overview

Describes the methods for creating new proxy objects.

NSXPCConnection implements this protocol. All objects returned from the methods in this protocol also implement the protocol. This allows creation of new proxies from other proxies.

Tasks

Miscellaneous

Instance Methods

remoteObjectProxy

Returns a proxy object with no error handling block. (required)

- (id)remoteObjectProxy;
Discussion

Messages sent to the proxy object are sent over the wire to the other side of the connection. All messages must be 'void' return type. Control may be returned to the caller before the message is sent. The resulting proxy object conforms to the NSXPCProxyCreating protocol.

Availability
  • Available in OS X v10.8 and later.
Declared In
NSXPCConnection.h

remoteObjectProxyWithErrorHandler:

Returns a proxy object that invokes the error handling block if an error occurs on the connection. (required)

- (id)remoteObjectProxyWithErrorHandler:(void (^)(NSError *))handler;
Parameters
handler

The error handling block that the proxy object should call when an error occurs while waiting for a reply.

Discussion

If the message sent to the proxy has a reply handler, then either the error handler or the reply handler is called exactly once.

The resulting proxy object conforms to the NSXPCProxyCreating protocol.

Availability
  • Available in OS X v10.8 and later.
Declared In
NSXPCConnection.h