freerdp-sys 0.1.0

Low-level Rust FFI bindings to FreeRDP 3.x (Remote Desktop Protocol). Supports vendored CMake builds from source or linking against system-installed FreeRDP. Bindings generated via bindgen. General-purpose — usable by any Rust project needing RDP client/server functionality.
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
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101

//! Pre-generated FreeRDP 3.x bindings.
//!
//! This file is checked in so that downstream users can build without libclang.
//! To regenerate, build with the `generate-bindings` feature enabled:
//!
//! ```sh
//! cargo build --features generate-bindings
//! # Then copy from target/<profile>/build/freerdp-sys-*/out/bindings.rs
//! ```
//!
//! Alternatively, use the `scripts/regenerate-bindings.sh` helper.
//!
//! WARNING: This is a placeholder. Run the regeneration script after cloning
//! with the FreeRDP submodule initialized to produce the actual bindings.

// Placeholder — replace with actual generated bindings via:
//   cargo build --features vendored,generate-bindings
//   cp target/debug/build/freerdp-sys-*/out/bindings.rs src/bindings.rs

#![allow(unused)]

use std::os::raw::{c_char, c_int, c_uint, c_void};

/// Opaque FreeRDP instance handle.
#[repr(C)]
#[derive(Debug, Copy, Clone)]
pub struct rdp_freerdp {
    _unused: [u8; 0],
}

/// Opaque FreeRDP settings handle.
#[repr(C)]
#[derive(Debug, Copy, Clone)]
pub struct rdp_settings {
    _unused: [u8; 0],
}

/// Opaque FreeRDP context handle.
#[repr(C)]
#[derive(Debug, Copy, Clone)]
pub struct rdp_context {
    _unused: [u8; 0],
}

/// Opaque FreeRDP input handle.
#[repr(C)]
#[derive(Debug, Copy, Clone)]
pub struct rdp_input {
    _unused: [u8; 0],
}

/// Opaque WinPR stream handle.
#[repr(C)]
#[derive(Debug, Copy, Clone)]
pub struct wStream {
    _unused: [u8; 0],
}

/// Settings instance count constant.
pub const FREERDP_SETTINGS_INSTANCE_COUNT: c_uint = 1;

extern "C" {
    /// Create a new FreeRDP instance.
    pub fn freerdp_new() -> *mut rdp_freerdp;

    /// Free a FreeRDP instance.
    pub fn freerdp_free(instance: *mut rdp_freerdp);

    /// Create new settings with the given instance count.
    pub fn freerdp_settings_new(count: c_uint) -> *mut rdp_settings;

    /// Free settings.
    pub fn freerdp_settings_free(settings: *mut rdp_settings);

    /// Connect to the remote server.
    pub fn freerdp_connect(instance: *mut rdp_freerdp) -> c_int;

    /// Disconnect from the remote server.
    pub fn freerdp_disconnect(instance: *mut rdp_freerdp) -> c_int;

    /// Get the context associated with an instance.
    pub fn freerdp_get_context(instance: *const rdp_freerdp) -> *mut rdp_context;

    /// Get the settings associated with an instance.
    pub fn freerdp_get_settings(instance: *const rdp_freerdp) -> *mut rdp_settings;

    /// Get the input handle for sending input events.
    pub fn freerdp_get_input(instance: *const rdp_freerdp) -> *mut rdp_input;

    /// Check if the instance is connected.
    pub fn freerdp_is_connected(instance: *const rdp_freerdp) -> c_int;

    /// Get the last error code.
    pub fn freerdp_get_last_error(context: *const rdp_context) -> c_uint;

    /// Get a human-readable error string.
    pub fn freerdp_get_last_error_name(code: c_uint) -> *const c_char;

    /// Get a human-readable error description.
    pub fn freerdp_get_last_error_info(code: c_uint) -> *const c_char;
}