---
title: "init(endpoint:targetQueue:options:incomingMessageHandler:cancellationHandler:)"
framework: xpc
role: symbol
role_heading: Initializer
path: "xpc/xpcsession/init(endpoint:targetqueue:options:incomingmessagehandler:cancellationhandler:)-2jmkk"
---

# init(endpoint:targetQueue:options:incomingMessageHandler:cancellationHandler:)

Creates a new session object representing a connection to the xpc endpoint.

## Declaration

```swift
@preconcurrency convenience init(endpoint: XPCEndpoint, targetQueue: DispatchQueue? = nil, options: XPCSession.InitializationOptions = .none, incomingMessageHandler: (@Sendable (XPCDictionary) -> XPCDictionary?)? = nil, cancellationHandler: (@Sendable (XPCRichError) -> Void)? = nil) throws
```

## Parameters

- `endpoint`: The endpoint to create a session with.
- `targetQueue`: The GCD queue onto which session events will be submitted. This may be a concurrent queue. This parameter is optional, if the target queue is not specified the target queue will be libdispatch’s default target queue, defined as DISPATCH_TARGET_QUEUE_DEFAULT.
- `options`: Additional attributes which which to create the session.
- `incomingMessageHandler`: The handler block to be called when a message originated by the peer is received through the provided session. This parameter is optional. See setIncomingMessageHandler()
- `cancellationHandler`: The cancellation handler block that will be executed when this session is cancelled. This parameter is optional. See setCancellationHandler()

## Return Value

Return Value Returns a new session object. The returned session is activated by default and can be used to send messages.

## Discussion

Discussion note: A XPCRichError describing the details of the error that occurred. This will throw a XPCRichError if the specified endpoint is invalid or unavailable.