---
title: "setCancellationHandler(_:)"
framework: xpc
role: symbol
role_heading: Instance Method
path: "xpc/xpcsession/setcancellationhandler(_:)"
---

# setCancellationHandler(_:)

Sets a closure the session calls when it’s canceled.

## Declaration

```swift
@preconcurrency func setCancellationHandler(_ cancellationHandler: @escaping @Sendable (XPCRichError) -> Void)
```

## Parameters

- `cancellationHandler`: A closure that receives an error indicating why the session was canceled.

## Discussion

Discussion important: Only call this method on an inactive session.

## See Also

### Managing the life cycle

- [activate()](xpc/xpcsession/activate().md)
- [setIncomingMessageHandler(_:)](xpc/xpcsession/setincomingmessagehandler(_:)-2ukdh.md)
- [setIncomingMessageHandler(_:)](xpc/xpcsession/setincomingmessagehandler(_:)-5lu26.md)
- [setIncomingMessageHandler(_:)](xpc/xpcsession/setincomingmessagehandler(_:)-75ou9.md)
- [cancel(reason:)](xpc/xpcsession/cancel(reason:).md)