Trait std::os::windows::io::FromRawHandle

1.1.0 · source · 
pub trait FromRawHandle {
    // Required method
    unsafe fn from_raw_handle(handle: RawHandle) -> Self;
}
Available on Windows only.
Expand description

从原始句柄构造 I/O 对象。

Required Methods§

source

unsafe fn from_raw_handle(handle: RawHandle) -> Self

从指定的原始句柄创建一个新的 I/O 对象。

此函数通常用于消耗给定句柄的所有权，将关闭句柄的责任传递给返回的 object。 以这种方式使用时，返回的 object 将负责在 object 离开角色域时关闭它。

但是，并不严格要求使用所有权。对严格消耗所有权的 API 使用 From<OwnedHandle>::from 实现。

Safety

传入的 handle 必须:

  • 是一个有效的打开句柄，
  • 是可以通过 CloseHandle 释放的资源的句柄 (与 RegCloseKey 或其他关闭函数相反)。

请注意，句柄可能具有值 INVALID_HANDLE_VALUE (-1)，有时它是有效的句柄值。有关完整故事，请参见 这个。

Implementors§