KetraTerm
API · DevelopmentAll versions

setHostPolicy

fun setHostPolicy(policy: HostPolicy, onComplete: (Throwable?) -> Unit = mutationFailureHandler)

Applies policy after previously accepted view settings and geometry changes.

Call on the EDT. Session admission runs on a worker. onComplete runs on the EDT after application, with null on success or the failure otherwise. Rebinding, disposal, or session closure cancels obsolete work and reports CancellationException. The default completion logs operational failures.

Parameters

policy

immutable host security policy to apply to the bound session.

onComplete

completion callback, invoked once for an accepted request.

Throws

if called off the EDT, no session is bound, or the bounded mutation queue is full.