---
title: retain
framework: Kernel
role: symbol
role_heading: Instance Method
platforms: [driverkit 19.0+, macOS 10.15+]
path: kernel/osobject/3180947-retain
---

# retain

Retains the OSObject instance

## Declaration

```occ
virtual void retain(void);
```

## Discussion

Discussion Increases the retain count of the instance by one.

## See Also

### Managing the Object Lifecycle

- [init](kernel/osobject/3180945-init.md)
- [release](kernel/osobject/3180946-release.md)
- [free](kernel/osobject/3180944-free.md)
- [OSObjectPtr](driverkit/osobjectptr.md)
- [OSObjectRef](driverkit/osobjectref.md)