Type Method

connectionWithRegisteredName:host:

Returns the NSConnection object whose send port links it to the NSConnection object registered with the default NSPortNameServer under a given name on a given host.

Declaration

+ (instancetype)connectionWithRegisteredName:(NSString *)name host:(NSString *)hostName;

Parameters

name

The name of an NSConnection object.

hostName

The name of the host. The domain name hostName is an Internet domain name (for example, “sales.anycorp.com”). If hostName is nil or empty, then only the local host is searched for the named NSConnection object.

Return Value

The NSConnection object whose send port links it to the NSConnection object registered with the default NSPortNameServer under name on the host named hostName. Returns nil if no NSConnection object can be found for name and hostName.

The returned NSConnection object is a child of the default NSConnection object for the current thread (that is, it shares the default NSConnection object's receive port).

Discussion

To get the object vended by the NSConnection object, use the rootProxy instance method. The rootProxyForConnectionWithRegisteredName:host: class method immediately returns this object.

See Also

Getting a Remote Object

+ connectionWithRegisteredName:host:usingNameServer:

Returns the NSConnection object whose send port links it to the NSConnection object registered under a given name with a given server on a given host.

Deprecated
rootProxy

The proxy for the root object of the receiver’s peer in another application or thread.

Deprecated
+ rootProxyForConnectionWithRegisteredName:host:

Returns a proxy for the root object of the NSConnection object registered with the default NSPortNameServer under a given name on a given host.

Deprecated
+ rootProxyForConnectionWithRegisteredName:host:usingNameServer:

Returns a proxy for the root object of the NSConnection object registered with server under name on a given host.

Deprecated
remoteObjects

The local proxies for remote objects that have been received over the connection but not deallocated yet.

Deprecated
localObjects

The local objects that have been sent over the connection and still have proxies at the other end.

Deprecated