Module std::os::windows::ffi

This is supported on Windows only.

std::ffi 模块中原语的 Windows 特定扩展。

Overview

由于历史原因，Windows API 对字符串使用了一种格式可能不正确的 UTF-16 编码。具体来说，Windows 字符串中的 16 位代码单元可能包含 未配对在一起的孤立代理代码点。 Unicode 标准要求代理代码点 (在 U+D800 到 U+DFFF 范围内的代码点) 总是成对的，因为在 UTF-16 编码中，*surrogate code 单元对 * 用于编码单个字符。 为了与不强制执行这些配对的代码兼容，Windows 也不强制执行它们。

虽然不一定总是可以无损地将这样的字符串转换为有效的 UTF-16 字符串 (甚至 UTF-8)，但是通常希望能够无损地将这样的字符串往返于 Windows API 之间。 例如，某些 Rust 代码可能与某些 Windows API 一起成为 “bridging”，仅在这些 API 之间传递 WCHAR 字符串，而无需真正研究这些字符串。

如果确实需要 Rust 代码查看这些字符串，则可以通过用 U+FFFD REPLACEMENT CHARACTER 替换无效的序列来将它们转换为有效的 UTF-8，这可能是有损的，就像在其他处理字符串编码的 Rust API 中所做的那样。

OsStringExt 和 OsStrExt

OsString 是操作系统的首选表示形式中所拥有的字符串的 Rust 包装器。 在 Windows 上，此结构体通过 OsStringExt trait 的实现得到增强，该实现具有 OsStringExt::from_wide 方法。这使您可以从 &[u16] 切片创建 OsString。大概是从 WCHAR Windows API 中得到的切片。

同样，OsStr 是 Rust 包装器，用于从操作系统的首选表示形式中借用字符串。在 Windows 上，OsStrExt trait 提供了 OsStrExt::encode_wide 方法，该方法输出 EncodeWide 迭代器。 例如，您可以 collect 这个迭代器，以获得一个 Vec<u16>; 您以后可以获取指向此 vector 内容的指针，并将其提供给 Windows API。

这些 traits 与 OsString 和 OsStr 一起工作，这样就可以在 Windows 和后面往返字符串，而不会丢失数据，即使字符串是格式错误的 UTF-16。

Structs

EncodeWide

为潜在的格式不正确的 UTF-16 生成宽字符序列。

Traits

OsStrExt	Windows 特定于 OsStr 的扩展。
OsStringExt	Windows 特定于 OsString 的扩展。