---
title: NSDistantObjectRequest
framework: foundation
role: symbol
role_heading: Class
path: foundation/nsdistantobjectrequest
---

# NSDistantObjectRequest

An object used by the distributed objects system to help handle invocations between different processes.

## Declaration

```occ
@interface NSDistantObjectRequest : NSObject
```

## Overview

Overview Do not create NSDistantObjectRequest objects directly. Unless you are getting involved with the low-level details of distributed objects, there should never be a need to access an NSDistantObjectRequest. To intercept and possibly process requests yourself, implement the NSConnection delegate method connection:handleRequest:.

## Topics

### Getting Information About a Request

- [connection](foundation/nsdistantobjectrequest/connection.md)
- [conversation](foundation/nsdistantobjectrequest/conversation.md)
- [invocation](foundation/nsdistantobjectrequest/invocation.md)

### Raising a Remote Exception

- [replyWithException:](foundation/nsdistantobjectrequest/replywithexception:.md)

## Relationships

### Inherits From

- [NSObject](objectivec/nsobject-swift.class.md)

## See Also

### Legacy

- [NSMachPortDelegate](foundation/nsmachportdelegate.md)
- [NSConnectionDelegate](foundation/nsconnectiondelegate.md)
- [NSConnection](foundation/nsconnection.md)
- [NSDistantObject](foundation/nsdistantobject.md)
- [NSMachBootstrapServer](foundation/nsmachbootstrapserver.md)
- [NSMachPort](foundation/nsmachport.md)
- [MessagePort](foundation/messageport.md)
- [NSMessagePortNameServer](foundation/nsmessageportnameserver.md)
- [NSPortCoder](foundation/nsportcoder.md)
- [PortDelegate](foundation/portdelegate.md)
- [PortMessage](foundation/portmessage.md)
- [NSPortNameServer](foundation/nsportnameserver.md)
- [NSProtocolChecker](foundation/nsprotocolchecker.md)
- [NSSocketPortNameServer](foundation/nssocketportnameserver.md)