SecHostRemoveGuest
Removes a guest from a host.
Declaration
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 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 Seccsflags for possible values. Pass Kseccsdefaultflags for standard behavior.
Return Value
A result code. See Code Signing Services Result Codes.
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.