---
title: setOptions
framework: kernel
role: symbol
role_heading: Instance Method
path: kernel/oscollection/1569373-setoptions
---

# setOptions

Recursively sets option bits in this collection and all child collections.

## Declaration

```occ
virtual unsigned int setOptions(unsigned int options, unsigned int mask, void *context);
```

## Parameters

- `options`: A bitfield whose values turn the options on (1) or off (0).
- `mask`: A mask indicating which bits in options to change. Pass 0 to get the whole current options bitfield without changing any settings.
- `context`: Unused.

## Return Value

Return Value The options bitfield as it was before the set operation.

## Discussion

Discussion Kernel extensions should not call this function. The only option currently in use is kImmutable. Subclasses should override this function to recursively apply the options to their contents if the options actually change.