wslcsdk-sys 3.0.1

Raw FFI bindings for Microsoft.WSL.Containers (WSLC) SDK 3.0.1
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71

//! Microsoft.WSL.Containers 3.0.1 错误码定义
//!
//! 官方定义基址为 WSLC_E_BASE = 0x0600，采用 Windows ITF 设施的 HRESULT 格式。

use windows_sys::core::HRESULT;

/// WSLC 基础错误偏移码 (0x0600)
pub const WSLC_E_BASE: u32 = 0x0600;

/// 构造 FACILITY_ITF 类型的 HRESULT
const fn make_hresult(code: u32) -> HRESULT {
    // SEVERITY_ERROR (1) | FACILITY_ITF (4) << 16 | code
    (0x8004_0000 | code) as HRESULT
}

/// 镜像未找到 (0x80040601)
pub const WSLC_E_IMAGE_NOT_FOUND: HRESULT = make_hresult(WSLC_E_BASE + 1);

/// 容器 ID 前缀存在歧义，匹配到多个容器 (0x80040602)
pub const WSLC_E_CONTAINER_PREFIX_AMBIGUOUS: HRESULT = make_hresult(WSLC_E_BASE + 2);

/// 容器未找到 (0x80040603)
pub const WSLC_E_CONTAINER_NOT_FOUND: HRESULT = make_hresult(WSLC_E_BASE + 3);

/// 卷未找到 (0x80040604)
pub const WSLC_E_VOLUME_NOT_FOUND: HRESULT = make_hresult(WSLC_E_BASE + 4);

/// 容器当前未处于运行状态 (0x80040605)
pub const WSLC_E_CONTAINER_NOT_RUNNING: HRESULT = make_hresult(WSLC_E_BASE + 5);

/// 容器已处于运行状态 (0x80040606)
pub const WSLC_E_CONTAINER_IS_RUNNING: HRESULT = make_hresult(WSLC_E_BASE + 6);

/// 会话名称属于系统保留名称，不可使用 (0x80040607)
pub const WSLC_E_SESSION_RESERVED: HRESULT = make_hresult(WSLC_E_BASE + 7);

/// 会话名称格式不合法 (0x80040608)
pub const WSLC_E_INVALID_SESSION_NAME: HRESULT = make_hresult(WSLC_E_BASE + 8);

/// 网络未找到 (0x80040609)
pub const WSLC_E_NETWORK_NOT_FOUND: HRESULT = make_hresult(WSLC_E_BASE + 9);

/// Windows Update 搜索依赖组件失败 (0x8004060A)
pub const WSLC_E_WU_SEARCH_FAILED: HRESULT = make_hresult(WSLC_E_BASE + 10);

/// SDK 版本落后，需要更新 (0x8004060B)
pub const WSLC_E_SDK_UPDATE_NEEDED: HRESULT = make_hresult(WSLC_E_BASE + 11);

/// 容器功能被系统或安全策略禁用 (0x8004060C)
pub const WSLC_E_CONTAINER_DISABLED: HRESULT = make_hresult(WSLC_E_BASE + 12);

/// 镜像仓库访问被安全策略拦截 (0x8004060D)
pub const WSLC_E_REGISTRY_BLOCKED_BY_POLICY: HRESULT = make_hresult(WSLC_E_BASE + 13);

/// 存储卷当前不可用或被独占占用 (0x8004060E)
pub const WSLC_E_VOLUME_NOT_AVAILABLE: HRESULT = make_hresult(WSLC_E_BASE + 14);

/// 会话未找到 (0x8004060F)
pub const WSLC_E_SESSION_NOT_FOUND: HRESULT = make_hresult(WSLC_E_BASE + 15);

/// WSL 虚拟机未在运行 (0x80040610)
pub const WSLC_E_VM_NOT_RUNNING: HRESULT = make_hresult(WSLC_E_BASE + 16);

/// 事件队列溢出，部分事件已丢失 (0x80040611)
pub const WSLC_E_EVENTS_LOST: HRESULT = make_hresult(WSLC_E_BASE + 17);

/// 事件流已传输完毕 (0x80040612)
pub const WSLC_E_EVENT_STREAM_FINISHED: HRESULT = make_hresult(WSLC_E_BASE + 18);

/// 容器已被删除 (0x80040613)
pub const WSLC_E_CONTAINER_DELETED: HRESULT = make_hresult(WSLC_E_BASE + 19);