# 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`. ``` func executeDistributedTarget(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 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. > Throws: 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. > ``` --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)