# windowsUiSessionSnapshot

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

Last updated: 2026-09-09

Package: host.windows | Status: source-declared

Tags: cpu, host, host.windows, method, source-example, thing, windows, yeho

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

```yh
external thing windowsUiSessionSnapshot
```

- 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.
- Describe() returns text: Describe.

## Use windowsUiSessionSnapshot

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

Verification: type checked

```yh
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))

```

Save this beside start.yh as project.mech:

```toml
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"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/host.windows--windowsUiSessionSnapshot/usage --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## windowsUiSessionSnapshot.Validate

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

Verification: type checked

```yh
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))

```

Save this beside start.yh as project.mech:

```toml
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"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/host.windows--windowsUiSessionSnapshot/method-Validate-11 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## windowsUiSessionSnapshot.Describe

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

Verification: type checked

```yh
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))

```

Save this beside start.yh as project.mech:

```toml
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"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/host.windows--windowsUiSessionSnapshot/method-Describe-12 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


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

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

AI training permission: https://demonhunterlabs.com/ai-use