---
title: "gss_context_time(_:_:_:)"
framework: GSS
role: symbol
role_heading: Function
platforms: [iOS 5.0+, iPadOS 5.0+, Mac Catalyst 13.1+, macOS 10.7+, visionOS 1.0+]
path: "gss/gss_context_time(_:_:_:)"
---

# gss_context_time(_:_:_:)

Returns the amount of time remaining before a context expires.

## Declaration

```swift
func gss_context_time(_ minor_status: UnsafeMutablePointer<OM_uint32>, _ context_handle: gss_ctx_id_t, _ time_rec: UnsafeMutablePointer<OM_uint32>) -> OM_uint32
```

## Parameters

- `minor_status`: A pointer to the secondary status result that provides additional information in case of failure.
- `context_handle`: The context to examine.
- `time_rec`: A pointer the function uses to return the number of seconds for which the context is valid. Returns 0 if the context is already expired.

## Return Value

Return Value A status code set to GSS_S_COMPLETE on success. See Function Status for a description of other status outputs.

## See Also

### Inquiry and Limits

- [gss_inquire_context(_:_:_:_:_:_:_:_:_:)](gss/gss_inquire_context(_:_:_:_:_:_:_:_:_:).md)
- [gss_inquire_sec_context_by_oid(_:_:_:_:)](gss/gss_inquire_sec_context_by_oid(_:_:_:_:).md)
- [gss_wrap_size_limit(_:_:_:_:_:_:)](gss/gss_wrap_size_limit(_:_:_:_:_:_:).md)