Contents

SecHostSelectedGuest

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

Declaration

OSStatus SecHostSelectedGuest(SecCSFlags flags, SecGuestRef *guestRef);

Parameters

  • flags:

    Optional flags; see Seccsflags for possible values. Pass Kseccsdefaultflags for standard behavior.

  • guestRef:

    On return, the guest code object of the current selected guest for the calling thread. If no guest is active on this thread (that is, the thread is acting for the host), the value returned is Ksecnoguest.

Return Value

A result code. See Code Signing Services Result Codes.

Discussion

This function may be called in either dynamic hosting mode or proxy hosting mode. If the host has more than one guest, it can set a different selected guest for each thread.