msica 0.2.0

Rust for Windows Installer Custom Actions
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

# Rust for Windows Installer Custom Actions


![latest version](https://img.shields.io/crates/v/msica?logo=rust)
![build status](https://github.com/heaths/msica-rs/actions/workflows/ci.yml/badge.svg?event=push)

Writing [custom actions] for [Windows Installer] can be difficult enough already,
but using Rust can help mitigate some potential issues concerning memory and handle leaks.

These APIs roughly mimic the Windows Installer [automation interface] for those APIs
that can be called in immediate and deferred custom actions.

## Example


You can define custom actions in Rust using its [foreign function interface][ffi] like:

```rust
use msica::*;

const ERROR_SUCCESS: u32 = 0;

#[no_mangle]

pub extern "C" fn MyCustomAction(h: MSIHANDLE) -> u32 {

    let session = Session::from(h);
    let record = Record::with_fields(
        Some("this is [1] [2]"),
        vec![Field::IntegerData(1), Field::StringData("example".to_owned())],
    );
    session.message(MessageType::User, &record);

    ERROR_SUCCESS
}
```

## License


This project is licensed under the [MIT license](LICENSE.txt).

[automation interface]: https://docs.microsoft.com/windows/win32/msi/automation-interface
[custom actions]: https://docs.microsoft.com/windows/win32/msi/custom-actions
[ffi]: https://doc.rust-lang.org/nomicon/ffi.html
[Windows Installer]: https://docs.microsoft.com/windows/win32/msi/about-windows-installer