ipmb 0.8.5

Inter-process message bus
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
72
73
74
75

use super::{security::SecurityAttr, Handle};
use crate::{util, Error};
use std::os::windows::prelude::{FromRawHandle, HandleOrInvalid, OwnedHandle};
use windows::{
    core::HSTRING,
    Win32::{Foundation, Storage::FileSystem, System::Pipes},
};

pub(crate) const DEFAULT_BUFFER_SIZE: u32 = 4 << 20;

pub unsafe fn anon_pipe(identifier: &str, sa: &SecurityAttr) -> Result<(Handle, Handle), Error> {
    let name: HSTRING = format!("\\\\.\\pipe\\{}.{}", identifier, util::rand_string(8)).into();

    // Create read pipe
    let pipe_handle = Pipes::CreateNamedPipeW(
        &name,
        FileSystem::PIPE_ACCESS_INBOUND
            | FileSystem::FILE_FLAG_OVERLAPPED
            | FileSystem::FILE_FLAG_FIRST_PIPE_INSTANCE,
        Pipes::PIPE_TYPE_MESSAGE | Pipes::PIPE_READMODE_MESSAGE | Pipes::PIPE_WAIT,
        1,
        DEFAULT_BUFFER_SIZE,
        DEFAULT_BUFFER_SIZE,
        0,
        Some(sa.attr()),
    );

    let pipe_handle: OwnedHandle = HandleOrInvalid::from_raw_handle(pipe_handle.0 as _)
        .try_into()
        .map_err(|_| windows::core::Error::from_win32())?;
    let read_pipe = Handle(pipe_handle);

    // Open write pipe
    let pipe_handle: Foundation::HANDLE = FileSystem::CreateFileW(
        &name,
        FileSystem::FILE_GENERIC_WRITE.0,
        FileSystem::FILE_SHARE_NONE,
        None,
        FileSystem::OPEN_EXISTING,
        // We write synchronously, otherwise may incorrectly report that the write operation is complete
        FileSystem::FILE_FLAGS_AND_ATTRIBUTES::default(),
        None,
    )?;

    let pipe_handle = OwnedHandle::from_raw_handle(pipe_handle.0 as _);
    let write_pipe = Handle(pipe_handle);

    Ok((read_pipe, write_pipe))
}

pub unsafe fn anon_pipe_half(sa: &SecurityAttr) -> Result<(Handle, String), Error> {
    let name = format!("\\\\.\\pipe\\{}", util::rand_string(8));
    let h_name: HSTRING = (&name).into();

    // Create read pipe
    let pipe_handle = Pipes::CreateNamedPipeW(
        &h_name,
        FileSystem::PIPE_ACCESS_INBOUND
            | FileSystem::FILE_FLAG_OVERLAPPED
            | FileSystem::FILE_FLAG_FIRST_PIPE_INSTANCE,
        Pipes::PIPE_TYPE_MESSAGE | Pipes::PIPE_READMODE_MESSAGE | Pipes::PIPE_WAIT,
        1,
        DEFAULT_BUFFER_SIZE,
        DEFAULT_BUFFER_SIZE,
        0,
        Some(sa.attr()),
    );

    let pipe_handle: OwnedHandle = HandleOrInvalid::from_raw_handle(pipe_handle.0 as _)
        .try_into()
        .map_err(|_| windows::core::Error::from_win32())?;
    let read_pipe = Handle(pipe_handle);

    Ok((read_pipe, name))
}