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.
Declaration
+ (NSDistantObject *) rootProxyForConnectionWithRegisteredName:(NSString *) name host:(NSString *) hostName;Parameters
- name:
The name under which the connection is registered.
- hostName:
The host name. The domain name
hostNameis an Internet domain name (for example,"sales.anycorp.com"). IfhostNameisnilor empty, then only the local host is searched for the namedNSConnectionobject.
Return Value
A proxy for the root object of the NSConnection object registered with the default NSPortNameServer under name on the host named hostName, or nil if that NSConnection object has no root object set. Also returns nil if no NSConnection object can be found for name and hostName.
Discussion
The NSConnection object of the returned proxy is a child of the default NSConnection object for the current thread (that is, it shares the default NSConnection object’s receive port).
This method invokes connectionWithRegisteredName:host: and sends the resulting NSConnection object a rootProxy message.