Windows通知设施的安全绑定

Windows通知设施（WNF） 是一种无需注册的发布者/订阅者机制，它于Windows 8中引入，并形成了Windows API的一个未经文档记录的部分。

此crate提供对（部分）此API的安全Rust抽象。如果您正在寻找对该API的原始绑定，请查看 ntapi crate。

请注意，尽管在创建这些抽象时非常注重内存安全性，但由于API的非文档性质，无法保证。

安装

此crate可在 crates.io 上找到。为了使用它，请将以下内容添加到您的 Cargo.toml 中的 dependencies 表格中

[dependencies]
wnf = "0.4.0"

此crate的一些功能仅在使用相应的 功能 时才可用。例如，为了启用 subscribe 功能

[dependencies]
wnf = { version = "0.4.0", features = ["subscribe"] }

这是一个仅适用于Windows的crate，在其他平台上编译会失败。如果您针对多个平台，建议将其声明为 特定平台依赖

[target.'cfg(windows)'.dependencies]
wnf = "0.4.0"

使用

有关如何使用此crate的详细说明，请参阅 crate文档。

有关示例，请参阅crate仓库中的 examples 文件夹。

最低支持的Rust版本（MSRV）策略

此crate当前的MSRV是 1.70。

增加此crate的MSRV不被视为重大更改。然而，在这种情况下，至少会有一个次要版本升级。此crate的每个版本都将至少支持发布时最新的四个稳定Rust版本。

变更日志

请参阅 CHANGELOG.md

许可证

在以下许可证下发布：

• Apache License, Version 2.0 (LICENSE-APACHE 或 https://apache.ac.cn/licenses/LICENSE-2.0)
• MIT 许可证 (LICENSE-MIT 或 https://opensource.org/licenses/MIT)

由您选择。

贡献

除非您明确声明，否则根据 Apache-2.0 许可证定义的任何有意提交以包含在作品中的贡献，应按上述方式双许可，不附加任何额外条款或条件。