---
title: "notify_register_dispatch(_:_:_:_:)"
framework: Darwin Notify
role: symbol
role_heading: Function
platforms: [iOS 3.2+, iPadOS 3.2+, Mac Catalyst 13.1+, macOS 10.6+, visionOS 1.0+, watchOS 2.0+]
path: "darwinnotify/notify_register_dispatch(_:_:_:_:)"
---

# notify_register_dispatch(_:_:_:_:)

Request notification delivery to a dispatch queue.

## Declaration

```swift
func notify_register_dispatch(_ name: UnsafePointer<CChar>!, _ out_token: UnsafeMutablePointer<Int32>!, _ queue: dispatch_queue_t!, _ handler: notify_handler_t!) -> UInt32
```

## Parameters

- `name`: (Input) The notification name.
- `out_token`: (Output) The registration token.
- `queue`: (Input) The dispatch queue to which the Block is submitted. The dispatch queue is retained by the notify subsystem while the notification is registered, and will be released when notification is canceled.
- `handler`: (Input) The Block to invoke on the dispatch queue in response to a notification. The notification token is passed to the Block as an argument so that the callee can modify the state of the notification or cancel the registration.

## Return Value

Return Value Returns status.

## Discussion

Discussion When notifications are received by the process, the notify subsystem will deliver the registered Block to the target dispatch queue. Notification blocks are not re-entrant, and subsequent notification Blocks will not be delivered for the same registration until the previous Block has returned.

## See Also

### Miscellaneous

- [notify_cancel(_:)](darwinnotify/notify_cancel(_:).md)
- [notify_check(_:_:)](darwinnotify/notify_check(_:_:).md)
- [notify_get_state(_:_:)](darwinnotify/notify_get_state(_:_:).md)
- [notify_post(_:)](darwinnotify/notify_post(_:).md)
- [notify_register_check(_:_:)](darwinnotify/notify_register_check(_:_:).md)
- [notify_register_mach_port(_:_:_:_:)](darwinnotify/notify_register_mach_port(_:_:_:_:).md)
- [notify_register_signal(_:_:_:)](darwinnotify/notify_register_signal(_:_:_:).md)
- [notify_resume(_:)](darwinnotify/notify_resume(_:).md)
- [notify_set_state(_:_:)](darwinnotify/notify_set_state(_:_:).md)
- [notify_suspend(_:)](darwinnotify/notify_suspend(_:).md)