host.windows · thing ·

windowsUiSessionSnapshot

A windows ui session snapshot record carrying processSessionId, connectState, acLineStatus, batteryFlag, batteryPercent, and related state.

cpuhosthost.windowsmethodsource-examplethingwindowsyeho

Connect Windows display, session, clipboard, and accessibility services.

external thing windowsUiSessionSnapshot

Status: source-declared

Fields and methods (13)
int processSessionId
Stores process session id as int.
int connectState
Stores connect state as int.
int acLineStatus
Stores ac line status as int.
int batteryFlag
Stores battery flag as int.
int batteryPercent
Stores battery percent as int.
bool applicationForeground
Stores application foreground as bool.
bool sessionActive
Stores session active as bool.
bool powerStatusAvailable
Stores power status available as bool.
bool connectStateAvailable
Stores connect state available as bool.
bool refreshed
Stores refreshed as bool.
windowsUiSessionSnapshot(int processSessionId, int connectState, int acLineStatus, int batteryFlag, int batteryPercent, bool applicationForeground, bool sessionActive, bool powerStatusAvailable, bool connectStateAvailable, bool refreshed)
Windows ui session snapshot.
Validate() returns text
Validate. Complete example
Describe() returns text
Describe. Complete example

Use windowsUiSessionSnapshot

A complete small caller. Values are illustrative; check the returned result and package requirements before connecting live resources.

cpu · source-example · type checked

using host.windows

// Connect Windows display, session, clipboard, and accessibility services.
windowsUiSessionSnapshot sample = windowsUiSessionSnapshot(1, 1, 1, 1, 1, true, true, true, true, true)
Console.Log(Text.From(sample.processSessionId))
project.mech
manifestVersion = "2"
package = "api.example.host_windows__windowsuisessionsnapshot"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "host.ui_services"
version = "0.1.0"
path = "../../../yeho/packages/host/ui_services"

[[dependencies]]
package = "host.windows"
version = "0.1.0"
path = "../../../yeho/packages/host/windows"

windowsUiSessionSnapshot.Validate

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

cpu · method · source-example · type checked

using host.windows

// Validate.
windowsUiSessionSnapshot instance = windowsUiSessionSnapshot(1, 1, 1, 1, 1, true, true, true, true, true)
text result = instance.Validate()
Console.Log(Text.From(result))
project.mech
manifestVersion = "2"
package = "api.example.host_windows__windowsuisessionsnapshot"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "host.ui_services"
version = "0.1.0"
path = "../../../yeho/packages/host/ui_services"

[[dependencies]]
package = "host.windows"
version = "0.1.0"
path = "../../../yeho/packages/host/windows"

windowsUiSessionSnapshot.Describe

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

cpu · method · source-example · type checked

using host.windows

// Describe.
windowsUiSessionSnapshot instance = windowsUiSessionSnapshot(1, 1, 1, 1, 1, true, true, true, true, true)
text result = instance.Describe()
Console.Log(Text.From(result))
project.mech
manifestVersion = "2"
package = "api.example.host_windows__windowsuisessionsnapshot"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "host.ui_services"
version = "0.1.0"
path = "../../../yeho/packages/host/ui_services"

[[dependencies]]
package = "host.windows"
version = "0.1.0"
path = "../../../yeho/packages/host/windows"
Notes and source

Package presence and a declaration do not establish support on every host. Host services need their platform and lifecycle setup.

yeho/packages/host/windows/session.yh:1