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

use crate::utilities;
use crate::Sid;
use std::ffi::OsString;
use std::io;
use std::ptr::null_mut;

/// Wraps [`ConvertSidToStringSidW`](https://docs.microsoft.com/en-us/windows/win32/api/sddl/nf-sddl-convertsidtostringsidw).
///
/// ```
/// use windows_permissions::{LocalBox, Sid, wrappers::ConvertSidToStringSid};
///
/// let string_sid = "S-1-5-123-456-789";
/// let sid: LocalBox<Sid> = string_sid.parse().unwrap();
/// let string_sid2 = ConvertSidToStringSid(&sid).unwrap();
///
/// assert_eq!(string_sid, string_sid2);
/// ```
#[allow(non_snake_case)]
pub fn ConvertSidToStringSid(sid: &Sid) -> io::Result<OsString> {
    let mut buf_ptr: *mut u16 = null_mut();
    let result = unsafe {
        winapi::shared::sddl::ConvertSidToStringSidW(sid as *const _ as *mut _, &mut buf_ptr)
    };

    if result == 0 {
        // Failed! No need to clean up
        Err(io::Error::last_os_error())
    } else {
        // Success! Copy the string into an OsString and free the original buffer
        let nul_pos = unsafe { utilities::search_buffer(&0x00, buf_ptr) };
        let slice_with_nul = unsafe { std::slice::from_raw_parts(buf_ptr, nul_pos + 1) };

        let os_string = utilities::os_from_buf(slice_with_nul);

        unsafe { winapi::um::winbase::LocalFree(buf_ptr as *mut _) };

        Ok(os_string)
    }
}