token-privilege 0.1.1

Safe Rust wrapper around Windows process token privilege and elevation detection APIs
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

//! Elevation detection for the current process.

use crate::error::TokenPrivilegeError;
use crate::ffi;

/// Check if the current process is running with elevated (Administrator) privileges.
///
/// Returns `true` if the process token indicates elevation.
///
/// # Errors
///
/// Returns an error if the process token cannot be opened or queried.
pub fn is_elevated() -> Result<bool, TokenPrivilegeError> {
    let token = ffi::open_current_process_token()?;
    ffi::query_elevation(&token)
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn is_elevated_returns_result() {
        let result = is_elevated();
        assert!(result.is_ok(), "is_elevated should return Ok on Windows");
    }

    #[test]
    fn is_elevated_is_consistent() {
        let first = is_elevated();
        assert!(first.is_ok(), "first call should succeed");
        let second = is_elevated();
        assert!(second.is_ok(), "second call should succeed");
        if let (Ok(f), Ok(s)) = (first, second) {
            assert_eq!(f, s, "elevation status should be stable");
        }
    }
}