Function

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

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

Guest Management

SecCodeCopyHost

Retrieves the code object for the host of specified guest code.

SecHostSelectGuest

Makes the calling thread the proxy for a specified guest.

Deprecated
SecHostSelectedGuest

Retrieves the handle for the guest currently selected for the calling thread.

Deprecated
SecHostSetHostingPort

Tells code signing services that the calling code will directly respond to hosting inquiries over the given port.

Deprecated
SecCodeMapMemory

Asks the kernel to accept the signing information currently attached to a code object and uses it to validate memory page-ins.