---
title: SecHostRemoveGuest
framework: security
role: symbol
role_heading: Function
path: security/sechostremoveguest
---

# SecHostRemoveGuest

Removes a guest from a host.

## Declaration

```occ
OSStatus SecHostRemoveGuest(SecGuestRef host, SecGuestRef guest, SecCSFlags flags);
```

## Parameters

- `host`: The guest code object of the host of the guest. You cannot specify a host of a host here except in the case of a dedicated host. For a dedicated host, the dedicated host is automatically substituted for its guest. See doc://com.apple.security/documentation/Security/kSecCSDedicatedHost for a discussion of dedicated hosts.
- `guest`: The guest code object for the guest whose guest relationship you wish to terminate.
- `flags`: Optional flags; see doc://com.apple.security/documentation/Security/SecCSFlags for possible values. Pass doc://com.apple.security/documentation/Security/SecCSFlags/kSecCSDefaultFlags for standard behavior.

## Return Value

Return Value A result code. See Code Signing Services Result Codes.

## Discussion

Discussion This function removes all memory of the guest-host relationship from the Code Signing Services hosting system. You cannot remove a dedicated guest. The specified guest must have been created using the SecHostCreateGuest function. If you remove a guest that is also a host, all of the guest’s guests are removed, recursively, as well, even if one or more of those guests are dedicated hosts.

## See Also

### Related Documentation

- [SecHostCreateGuest](security/sechostcreateguest.md)