---
title: "executeDistributedTarget(on:target:invocationDecoder:handler:)"
framework: distributed
role: symbol
role_heading: Instance Method
path: "distributed/distributedactorsystem/executedistributedtarget(on:target:invocationdecoder:handler:)"
---

# executeDistributedTarget(on:target:invocationDecoder:handler:)

Prepare and execute a call to the distributed function identified by the passed arguments, on the passed actor, and collect its results using the ResultHandler.

## Declaration

```swift
func executeDistributedTarget<Act>(on actor: Act, target: RemoteCallTarget, invocationDecoder: inout Self.InvocationDecoder, handler: Self.ResultHandler) async throws where Act : DistributedActor
```

## Parameters

- `actor`: Actor on which the remote call should invoke the target
- `target`: The target (method) identifier that should be invoked
- `invocationDecoder`: Used to obtain all arguments to be used to perform the target invocation
- `handler`: Used to provide a type-safe way for library code to handle the values returned by the target invocation.

## Discussion

Discussion This method encapsulates multiple steps that are invoked in executing a distributed function, into one very efficient implementation. The steps involved are: looking up the distributed function based on its name decoding, in an efficient manner, all arguments from the Args container into a well-typed representation using that representation to perform the call on the target method The reason for this API using a ResultHandler rather than returning values directly, is that thanks to this approach it can avoid any existential boxing, and can serve the most latency sensitive-use-cases. note: If the target location, invocation argument decoding, or some other mismatch between them happens. In general, this method is allowed to throw in any situation that might otherwise result in an illegal or unexpected invocation being performed.     Throws ``ExecuteDistributedTargetMissingAccessorError`` if the `target`     does not resolve to a valid distributed function accessor, i.e. the     call identifier is incorrect, corrupted, or simply not present in this process.